GridDB客户端请求触发10005 TXN_AUTH_FAILED错误，寻求排查方案

以下是该错误的潜在原因及对应的排查解决步骤：

潜在原因与排查步骤 #

1. 客户端与集群认证协议不匹配 #

GridDB的认证模式分为DEFAULT（用户名密码）和CERTIFICATE（证书认证）两种，两端配置不一致会直接触发认证失败：

• 登录集群管理节点，查看gs_cluster.json中的authenticationMode配置项；
• 确保客户端连接参数中的authenticationMode与集群配置完全一致：
  • 若集群用CERTIFICATE，客户端需配置对应的证书文件；
  • 若集群用DEFAULT，跳过证书相关配置。

2. 集群端用户配置异常 #

即使用户名密码正确，用户本身的状态或存在性问题也会导致认证失败：

• 在集群节点执行gs_passwd -l，确认目标用户名存在于用户列表中；
• 若用户不存在，执行gs_passwd -a 用户名创建用户并设置密码；
• 重新设置用户密码（避免旧哈希算法兼容问题）：执行gs_passwd 用户名，输入新密码后重试连接。

3. WSL网络连通性问题 #

WSL与Windows主机/GridDB集群的网络隔离可能导致认证请求未正常送达，错误提示被统一为认证失败：

• 在WSL中执行nc -zv 集群IP 10001（或telnet 集群IP 10001），确认GridDB默认端口10001可正常连通；
• 若集群部署在Windows主机上，WSL需使用主机内网IP而非localhost（WSL与Windows的localhost存在隔离）；
• 检查Windows防火墙是否允许10001端口的入站请求，或调整WSL网络模式为桥接模式。

4. 客户端与集群版本不兼容 #

客户端与集群版本差异可能导致认证协议不匹配：

• 在WSL中执行gs_client_version查看客户端版本，确保与集群版本（5.1.0-39692 CE）完全一致；
• 若版本不一致，卸载现有客户端后重新安装对应版本的GridDB客户端。

5. 客户端连接参数错误 #

除用户名密码外，其他参数错误也可能触发认证失败：

• 检查客户端连接命令/代码中的clusterName是否与集群配置的clusterName一致；
• 确认连接地址无拼写错误，若使用多节点集群，需确保所有节点地址正确配置。

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