CQLSH可连Cassandra但Java客户端无法通过外部IP连接求助

这问题我之前部署Docker版Cassandra时碰过好几次，核心原因一般是Cassandra的网络广播配置没适配Docker环境，或者Java驱动的连接参数没匹配上，咱们一步步来排查解决：

1. 修正Cassandra的关键网络配置 #

Docker容器里的Cassandra需要正确配置广播地址，不然Java驱动会拿到容器内部的私有IP，导致连接失败。修改容器内的cassandra.yaml配置文件：

• 把rpc_address设为0.0.0.0（允许从任意地址接收RPC请求）
• 将broadcast_rpc_address设置为你的服务器外部IP（也就是你用cqlsh连接的14.24.34.44）
• 同时确保listen_address是0.0.0.0，broadcast_address也同步设为外部IP

修改后的关键配置片段：

listen_address: 0.0.0.0
broadcast_address: 14.24.34.44
rpc_address: 0.0.0.0
broadcast_rpc_address: 14.24.34.44

修改完成后重启Cassandra容器：

docker restart <你的Cassandra容器名称/ID>

2. 检查Java驱动的连接参数 #

确保你的Java客户端代码没有配置错误：

• 明确指定外部IP和9042端口
• 因为服务器日志显示是unencrypted，所以要禁用SSL（如果驱动默认开启的话）
• 驱动版本要和Cassandra版本兼容（比如Cassandra 3.11.x对应DataStax Java Driver 3.11.x，Cassandra 4.x对应Driver 4.x）

示例连接代码：

import com.datastax.driver.core.Cluster;
import com.datastax.driver.core.Session;

public class CassandraConnector {
    public static void main(String[] args) {
        try {
            Cluster cluster = Cluster.builder()
                    .addContactPoint("14.24.34.44")
                    .withPort(9042)
                    .withSSL(false) // 必须和服务器加密方式一致
                    .build();
            Session session = cluster.connect();
            System.out.println("连接成功！");
            session.close();
            cluster.close();
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

3. 排查防火墙/安全组限制 #

虽然你能用cqlsh连接，但还是要确认：

• 服务器的入站规则是否开放了9042端口给Java客户端所在的IP（如果是云服务器，重点检查安全组配置）
• Java客户端所在机器的出站规则是否允许访问9042端口

4. 验证Cassandra的监听状态 #

可以在服务器上执行以下命令，确认Cassandra确实在监听0.0.0.0:9042：

netstat -tulpn | grep 9042

如果输出显示0.0.0.0:9042，说明监听状态正常。

按照这几步操作下来，应该就能解决Java客户端无法连接的问题了。

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