GridDB错误码1002：“Container not found”问题排查求助

架构老林

2026-7-18

GridDB错误码1002（Container not found）排查方案

检查容器所属数据库/命名空间
确认代码连接的数据库（或命名空间）与容器实际归属的是否一致。GridDB容器属于特定数据库，若代码连接默认库但容器创建在自定义库下，会触发找不到容器的错误。可通过gs_sh工具执行命令验证：
```
show containers in database <db_name>;
```
验证连接参数的集群/节点配置
核对代码中GridDB的连接地址、集群名称是否正确。若连接的集群节点未同步到容器元数据（比如刚创建容器后同步未完成），也会返回该错误。可尝试连接集群VIP或全节点列表，或等待1-2分钟让元数据完成同步。
检查容器状态
容器可能处于离线、冻结或删除中状态。通过gs_sh执行命令查看容器状态：
```
show containers;
```
确认目标容器的STATUS列显示为ACTIVE，若状态异常需先恢复（如解冻容器、重启节点同步）。
核对API调用的容器名称格式
部分GridDB SDK要求容器名称带上数据库前缀（格式为<db_name>.<container_name>），若代码仅写容器名且容器不在默认数据库，会导致查找失败。检查代码中容器名称是否包含正确的数据库前缀。
检查用户权限配置
当前连接GridDB的用户需具备目标容器的访问权限。通过gs_sh执行命令查看权限：
```
show privileges for user <username>;
```
若权限不足，执行授权命令：
```
grant all on container <container_name> to user <username>;
```
排查SDK版本兼容性
确认使用的GridDB SDK版本与服务器版本匹配。版本差异可能导致元数据解析错误，出现容器找不到的情况，建议将SDK升级至与服务器一致的版本。
查看GridDB服务器日志
登录GridDB服务器，查看节点日志文件（默认路径/var/lib/griddb/log/gs_node*.log），搜索Container not found相关记录，日志会提供具体的容器名、数据库名、请求来源等细节，帮助定位根本问题。