Java驱动连接Cassandra报local DC必须显式设置问题排查

报错核心原因是运行时代码中dataCenter变量实际为null，导致builder.withLocalDatacenter(dataCenter)配置逻辑未执行，Cassandra驱动未拿到显式设置的本地数据中心参数，触发了"显式指定contact points时必须显式设置本地DC"的校验错误。
现有代码的DC配置加了非空判断：

if ( dataCenter != null ) builder.withLocalDatacenter( dataCenter );

只有dataCenter非null时才会注入DC配置，虽然代码里写了方法调用，但运行时传入参数为空，配置并未实际生效。
以下两种场景也会触发同类报错：

• 传入的dataCenter是空字符串、全空格的无效值
• 传入的DC名称和集群实际配置的本地数据中心名称不匹配，存在大小写差异、多余空格、名称写错等问题

• 校验运行时参数：通过日志或断点确认传入的dataCenter实际值，排除null、空串、全空格的无效情况。如果不确定集群正确的DC名称，可登录集群执行CQL语句SELECT data_center FROM system.local;查询获取准确值，注意DC名称大小写敏感，必须完全匹配。
• 优化参数校验逻辑，把空字符串场景也纳入校验，避免无效配置传入，参考修改：

if (dataCenter != null && !dataCenter.trim().isEmpty()) {
    builder.withLocalDatacenter(dataCenter.trim());
} else {
    throw new IllegalArgumentException("创建Cassandra连接必须指定有效的本地数据中心参数dataCenter");
}

• 排查contact point列表：确认传入的host列表中没有混入其他数据中心的节点，配置的本地DC为应用部署位置就近的同机房数据中心，不要跨DC指定。

额外提示：当前代码存在端口解析隐患：port变量定义在for循环外部，如果hosts列表里前一个host带自定义端口，后一个host不带端口，会直接沿用前一个host的端口值，建议把port的初始化放到for循环内部，每次解析host前重置为默认值9042，避免端口错配。

内容的提问来源于stack exchange，提问作者DbSchema