GridDB Java客户端连接失败：因通知超时触发JC_BAD_CONNECTION错误

背景 #

我在尝试用Java客户端连接本地运行的GridDB Docker容器，已经配置了正确的集群参数和凭据，但一直遇到JC_BAD_CONNECTION错误，提示接收通知更新时超时。我的目标是通过Java API往GridDB容器里插入数据，当前用Maven管理项目依赖，GridDB使用的是官方Docker镜像。

排查与解决建议 #

这种连接问题我之前也碰到过几次，咱们一步步来梳理：

• 检查Docker端口映射是否完整
  GridDB的通知服务默认使用31999端口，启动容器时必须把这个端口映射到本地主机，否则Java客户端根本无法访问容器内的通知服务。启动容器的命令要确保包含必要的端口映射：

  docker run -d -p 31999:31999 -p 10001:10001 -p 20001:20001 griddb/griddb:latest
  

  上面的命令同时映射了通知端口31999、SQL端口10001和集群端口20001，这些都是连接和操作GridDB的常用必要端口。

• 确认Java客户端的集群配置是否正确
  一定要在客户端代码里指定正确的通知成员地址——也就是localhost:31999（因为Docker已经把容器的31999端口映射到了本地）。初始化GridStore的代码示例如下：

  Properties props = new Properties();
  props.setProperty("notificationMember", "localhost:31999");
  props.setProperty("user", "admin");
  props.setProperty("password", "admin");
  GridStore store = GridStoreFactory.getInstance().getGridStore(props);
  

  别把端口误写成SQL端口10001之类的，那样肯定连不上通知服务。

• 检查本地防火墙/安全软件的拦截
  很多时候本地防火墙或杀毒软件会默认拦截陌生端口的通信，你可以临时关闭防火墙测试是否能连接，如果能连上，记得把31999端口加入防火墙的允许列表。

• 验证GridDB容器是否正常启动
  用docker logs <容器ID>查看容器的启动日志，确认有没有报错信息。如果日志里出现类似“Cluster start successfully”的内容，说明集群初始化正常；如果有端口占用或初始化失败的报错，得先解决容器本身的问题。

• 确保客户端与GridDB版本兼容
  Java客户端的版本必须和Docker容器里的GridDB版本完全匹配，比如容器用的是5.5.0版本，客户端也要用5.5.0的Maven依赖。你可以在pom.xml里确认依赖版本：

  <dependency>
      <groupId>com.toshiba.mwcloud.gs</groupId>
      <artifactId>gridstore</artifactId>
      <version>5.5.0</version>
  </dependency>
  

  版本不兼容很容易引发各种奇怪的连接问题。

• 确认连接凭据是否正确
  GridDB默认的用户名是admin、密码是admin，如果启动容器时修改了默认凭据，那客户端代码里也要对应更新，不然可能会因为权限问题导致连接失败（有时候也会表现为超时错误）。

备注：内容来源于stack exchange，提问作者hordlaw