GridDB Java客户端连接Docker实例时遇[TXN_CLUSTER_NAME_INVALID]错误

核心问题定位 #

你使用的GridDB Docker镜像（arm-5.5.0版本）默认集群名并非defaultCluster，而是griddb，这是导致TXN_CLUSTER_NAME_INVALID错误的直接原因。

快速修复：修正Java连接配置 #

将代码中的集群名属性值改为griddb即可解决连接问题：

props.setProperty("clusterName", "griddb");

可选方案：自定义Docker容器集群名 #

如果需要将集群名设置为defaultCluster，可以在启动容器时通过环境变量指定：

docker run -d --name griddb-server -p 10001:10001 -e CLUSTER_NAME=defaultCluster griddbnet/griddb:arm-5.5.0

容器内验证集群名的两种方法 #

方法1：查看集群配置文件 #

1. 进入运行中的GridDB容器：

docker exec -it griddb-server /bin/bash

2. 读取集群配置文件内容：

cat /var/lib/gridstore/conf/gs_cluster.json

在输出结果中找到clusterName字段，即可确认当前集群名称。

方法2：使用命令行工具查询 #

1. 进入容器后启动GridDB命令行工具：

gs_sh

2. 在交互模式下执行查询命令：

show cluster;

输出结果中会明确显示当前集群的名称信息。

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