3meta+3tskv架构CnosDB 2.4.0集群数据库可见性异常求助

问题现象 #

部署3meta+3tskv架构的CnosDB 2.4.0（revision 6b3d820b336c6f83d1cc2f237ba206f0e1fee47b）集群时出现以下异常：

• 执行show databases命令，结果中无法找到write_alter数据库
• 执行create database write_alter命令，返回错误：

  422 Unprocessable Entity, details: {"error_code":"030018","error_message":"Database \"write_alter\" already exists"}
  

可能原因及解决方法 #

1. Meta节点数据不一致 #

多Meta节点集群可能存在元数据同步延迟或数据不一致，导致查询时从部分节点获取的库列表不完整，但创建操作会检测到其他节点已存在该库记录。

• 解决步骤：
  • 登录所有Meta节点，检查元数据存储（默认RocksDB）中是否存在write_alter的相关记录
  • 依次重启所有Meta节点，等待节点间元数据同步完成
  • 重新执行show databases验证结果

2. 数据库状态异常 #

数据库可能处于创建中断后的"半初始化"状态：元数据标记为已存在，但未完成全集群注册流程，导致无法正常展示。

• 解决步骤：
  • 尝试删除异常数据库后重新创建（操作前确认无需要保留的数据）：

    drop database write_alter;
    create database write_alter;
    

  • 若删除命令执行失败，可通过CnosDB元数据管理工具手动清理异常记录

3. 查询路由异常 #

客户端查询请求可能被路由到了未同步最新元数据的节点，导致返回的库列表不完整。

• 解决步骤：
  • 分别连接集群中不同的Meta节点执行show databases，确认是否存在节点间结果差异
  • 检查集群负载均衡配置，确保查询请求能均匀分发至所有Meta节点

同类问题反馈 #

在CnosDB社区讨论中，已有部分2.4.x版本的多Meta集群用户反馈过类似问题，该问题多与元数据同步机制的偶发异常有关，通过重启Meta节点或手动同步元数据可解决。

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