GridDB Java客户端连接失败：无法连接至GridDB服务器求助

问题场景 #

使用官方GridDB Java Client Library集成时，连接代码如下：

import java.util.Properties;
import com.toshiba.mwcloud.gs.GridStore;
import com.toshiba.mwcloud.gs.GridStoreFactory;

public class GridDBConnectionTest {
    public static void main(String[] args) {
        Properties props = new Properties();
        props.setProperty("notificationAddress", "239.0.0.1");
        props.setProperty("notificationPort", "31999");

        try {
            GridStore gridstore = GridStoreFactory.getInstance().getGridStore(props);
            System.out.println("Successfully connected to GridDB server.");
            gridstore.close();
        } catch (Exception e) {
            System.err.println("Failed to connect to GridDB server: " + e.getMessage());
            e.printStackTrace();
        }
    }
}

运行后持续报错：

Failed to connect to GridDB server: Error occurred while getting connection: [hosts=239.0.0.1:31999] Failed to connect to any of given addresses

已确认服务器启动且地址端口配置一致，以下是可能的原因及解决方案：

可能的原因及解决方案 #

1. 多播网络环境限制 #

239.0.0.1是GridDB默认的多播地址，部分环境会限制多播通信：

• 场景：云服务器、Docker容器、禁用多播策略的局域网等环境下，多播数据包无法正常传输。
• 解决：
  • 切换为单播模式，直接指定GridDB节点的IP和服务端口（默认10001）：

    props.setProperty("notificationMember", "192.168.1.100:10001"); // 替换为实际节点IP
    

  • 检查服务器与客户端的防火墙规则，开放31999端口的多播流量（UDP协议）。

2. 客户端与服务器版本不兼容 #

GridDB客户端与服务器的版本必须严格匹配，否则会因协议不兼容导致连接失败：

• 解决：
  • 确认客户端依赖版本与服务器版本完全一致（如服务器为5.5.0，客户端也需使用5.5.0版本的jar包）。
  • 参考官方文档的版本兼容矩阵，确保版本匹配。

3. 缺少必要的连接认证属性 #

仅配置地址和端口不足以完成身份验证，需补充集群名称、用户名和密码：

• 解决：
  添加默认认证信息（可根据实际服务器配置修改）：

  props.setProperty("clusterName", "defaultCluster");
  props.setProperty("user", "admin");
  props.setProperty("password", "admin");
  

4. 客户端依赖缺失或错误 #

未引入完整的GridDB客户端依赖会导致连接逻辑异常：

• 解决：
  • 若使用Maven，确保pom.xml中依赖配置正确：

    <dependency>
        <groupId>com.toshiba.mwcloud.gs</groupId>
        <artifactId>gs_client</artifactId>
        <version>5.5.0</version> <!-- 与服务器版本一致 -->
    </dependency>
    

  • 手动引入jar包时，需包含官方下载包lib目录下的所有依赖文件（如netty相关jar）。

5. 服务器监听配置异常 #

服务器可能未正确监听指定的多播地址或端口：

• 解决：
  • 检查服务器配置文件gs_cluster.json，确认notificationAddress和notificationPort与客户端配置完全一致。
  • 重启GridDB服务，确保配置修改生效。

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