Docker Compose中MongoDB副本集初始化健康检查失败原因排查

核心失败原因 #

• 重复执行rs.initiate()的副作用
  每次健康检查都会触发rs.initiate()，当副本集已经初始化完成后，该命令会返回ok:0的错误结果。虽然你用了||逻辑，但如果此时副本集状态波动（比如节点临时不可达），rs.status().ok也会返回0，直接导致健康检查不通过。而且重复执行初始化命令还可能干扰副本集的正常运行，加剧状态异常。

• mongosh输出非纯数值导致判断失效
  当rs.initiate()执行失败（副本集已存在），mongosh会输出错误文本（如MongoServerError: Attempted to initiate a replica set but one is already running），而非单纯的0。此时$$(...)捕获的内容不是数字，test ... -eq 1会直接判定为不相等，触发健康检查失败。

• 副本集节点未完全就绪的状态波动
  depends_on仅保证容器启动顺序，不确保mongodb2、mongodb3节点完全就绪并加入副本集。在健康检查执行时，若这两个节点未完成初始化，rs.status()会返回副本集状态不健康的结果，ok字段为0，导致检查失败。

适配项目需求的健康检查调整方案 #

修改健康检查逻辑，仅在副本集未初始化时执行rs.initiate()，避免重复执行带来的问题：

healthcheck:
  test: |
    test $$(mongosh --port 27017 --quiet --eval "
      try {
        // 先检查副本集是否已正常运行
        if (rs.status().ok === 1) {
          1;
        } else {
          0;
        }
      } catch (e) {
        // 捕获副本集未初始化的错误，执行初始化
        rs.initiate({_id:'rs0',members:[{_id:0,host:\"mongodb1:27017\"},{_id:1,host:\"mongodb2:27018\"},{_id:2,host:\"mongodb3:27019\"}]}).ok;
      }
    ") -eq 1
  interval: 10s
  start_period: 30s
  timeout: 60s

这个逻辑的核心是：

1. 用try-catch处理副本集未初始化时rs.status()抛出的错误
2. 仅在副本集未初始化时执行rs.initiate()
3. 已初始化的情况下，直接检查副本集状态是否正常

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