如何解决Go API连接Google Cloud服务器上Cassandra数据库的超时问题

你遇到的报错gocql: unable to create session: control: unable to connect to initial hosts: dial tcp xx.xxx.xxx.xxx:9042: i/o timeout本质是Go程序所在设备无法通过网络访问Cassandra服务的9042端口，常见原因和对应解决方法如下：

核心错误原因 #

• Cassandra配置错误：你提到将监听地址和RPC地址改为了Go程序的运行IP，这是配置逻辑错误。Cassandra的listen_address是节点自身用于集群内部通信的地址，native_transport_address（旧版本为rpc_address）是监听客户端连接的地址，二者都需要绑定Cassandra服务器本机存在的IP，绑定客户端IP会导致Cassandra无法正常监听端口，甚至启动失败。
• 网络规则未生效：GCP防火墙规则可能未正确绑定到Cassandra所在的VM实例、源IP范围配置错误、或端口规则未启用。
• 服务器本地防火墙拦截：Cassandra服务器内部的系统防火墙（如ufw、firewalld）未放通9042端口。
• Cassandra服务异常：服务未正常启动，或9042端口仅监听在127.0.0.1本地地址。

分步解决方法 #

• 修正Cassandra配置：编辑cassandra.yaml文件，调整以下参数：
  • listen_address：填写Cassandra服务器的GCP内网IP，单节点部署也可填0.0.0.0
  • native_transport_address（旧版本填rpc_address）：填0.0.0.0允许所有客户端IP连接，也可指定你的Go程序公网IP做访问限制
  • 单节点部署时确认seed_provider配置中的种子节点地址为服务器自身IP
    配置修改完成后执行systemctl restart cassandra重启服务，执行systemctl status cassandra确认服务正常运行。
• 验证端口监听状态：在Cassandra服务器执行命令ss -tulpn | grep 9042，确认端口监听地址为0.0.0.0或服务器公网/内网IP，而非127.0.0.1。
• 排查网络连通性：在运行Go程序的设备上执行命令nc -zv 你的Cassandra公网IP 9042验证连通性，如果连接失败依次检查：
  • GCP防火墙入站规则是否绑定到Cassandra所在VM实例，源IP是否为你运行Go程序的公网IP，TCP 9042端口是否已放通
  • 执行ufw status或firewall-cmd --list-all检查服务器本地防火墙是否放通9042端口，未放通则执行ufw allow 9042/tcp添加规则
• 修正Go代码配置：如果你的Cassandra开启了账号密码认证，需要在代码中添加认证配置：

  cluster.Authenticator = gocql.PasswordAuthenticator{
      Username: "你的Cassandra账号",
      Password: "你的Cassandra密码"
  }
  

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