使用Python API连接GridDB出现超时错误的排查与解决

问题重现 #

使用Python API连接GridDB时触发超时错误，代码如下：

import griddb_python as griddb

factory = griddb.StoreFactory.get_instance()
store = factory.get_store(
    host='localhost',
    port=2406,
    cluster_name='mycluster',
    username='admin',
    password='admin'
)

conInfo = griddb.ContainerInfo("mycontainer",
                               [["id", griddb.Type.INTEGER],
                                ["name", griddb.Type.STRING]],
                               griddb.ContainerType.COLLECTION, True)

con = store.get_container(conInfo)

错误信息：

griddb_python.GSException: [TIMEOUT] Timeout expired

可能成因及解决方法 #

1. GridDB服务未正常启动或未监听指定端口 #

• 检查服务状态：Linux执行 systemctl status griddb，确认服务处于active (running)；Windows在服务列表中找到GridDB服务，确认已启动。
• 验证端口监听：Linux执行 netstat -anp | grep 2406，Windows执行 netstat -ano | findstr 2406，确认2406端口处于LISTEN状态。若未监听，检查GridDB配置文件（如gs_cluster.json）中的notificationMember配置，确保端口设置为2406。

2. 集群名称与服务器配置不匹配 #

• 打开GridDB集群配置文件gs_cluster.json，查找clusterName字段，确认其值与代码中cluster_name='mycluster'完全一致（区分大小写）。

3. 防火墙或网络策略限制连接 #

• 临时关闭防火墙测试：Linux执行 systemctl stop firewalld，Windows临时禁用防火墙防护。若连接成功，需在防火墙上添加规则，允许2406端口的TCP入站连接。
• 若GridDB部署在远程服务器，需确认云服务器安全组已开放2406端口。

4. 连接超时参数设置过短 #

• 在get_store方法中显式增加超时参数，延长连接等待时间：

store = factory.get_store(
    host='localhost',
    port=2406,
    cluster_name='mycluster',
    username='admin',
    password='admin',
    timeout=30  # 设置为30秒，可根据实际调整
)

5. Python客户端与GridDB服务器版本不兼容 #

• 执行pip show griddb_python查看客户端版本，执行gs_stat -v查看服务器版本，确认两者版本匹配。若差异过大，升级或降级客户端至兼容版本。

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