如何用Docker Compose配置脚本部署容器内MongoDB副本集事务支持

直接用 docker-compose 启动三个 MongoDB 容器就以为是副本集？那可太天真了。很多开发者都踩过这个坑——虽然容器跑起来了，端口映射了，数据卷也挂上了，结果执行 rs.status() 时直接返回 NoReplicationEnabled。问题的根源在于：副本集并非靠“三个容器”的数量自动形成，核心原因在于缺少两个关键步骤——没有执行 rs.initiate()，而且节点之间彼此无法发现。容器启动后它们是独立的 mongod 实例，互相不认识，必须手动建立连接。理解这一点是 Docker MongoDB 副本集部署的首要前提。

要正确配置，每个容器必须拥有固定的 hostname（例如 mongo1、mongo2），绝不能依赖 Docker 自动生成的随机字符。节点间通信必须走自定义网络内的内部 DNS，而不是 localhost 或宿主机 IP。另外，mongod 进程启动时必须带上 --replSet 参数，否则它根本不会响应任何副本集相关命令。最后一步，初始化操作只能在一个节点上执行一次，并且必须等待所有节点都进入 ready 状态——即监听端口通畅、能响应 ping 之后，再执行 rs.initiate()。这几步是 MongoDB 副本集初始化流程中最容易忽略的细节。

控制初始化顺序和时机，是实践中最容易出错的地方。官方 mongod 镜像没有内置自动化逻辑，所以我们必须自己编写脚本，配合健康检查（healthcheck）来依次完成。大致流程是：先让三个 mongod 都启动起来，然后通过自定义 entrypoint 脚本等待所有节点健康，最后挑一个主节点执行初始化。单纯依赖 depends_on 并不够，因为它只能保证容器进程启动，却不关心 MongoDB 是否已经就绪。

具体怎么做？每个服务都要加上 healthcheck，使用 mongosh --eval "db.runCommand({ping:1})" 这类命令探测连通性，间隔设为 10 秒，超时 5 秒，重试 5 次。然后通过 entrypoint 覆盖默认启动命令，包装成“启动 mongod → 等待其他节点就绪 → 条件性执行初始化”三步流程。只让 mongo1 容器执行初始化，判断条件可以用环境变量或主机名，避免 mongo2 或 mongo3 也跑去执行一遍，导致 already initialized 错误。副本集配置里所有成员的地址必须写成 mongo1:27017、mongo2:27017 这种容器内可解析的 hostname，绝对不能写 127.0.0.1。这样的 Docker 副本集自动化初始化脚本才能一次成功。

再来看看 docker-compose.yml 中那些容易忽略的关键参数。下面这个片段聚焦了最核心的部分：

version: '3.8'
services:
  mongo1:
    image: mongo:7.0
    hostname: mongo1
    command: mongod --replSet rs0 --bind_ip_all --port 27017
    healthcheck:
      test: ["CMD", "mongosh", "--eval", "db.runCommand({ping:1})"]
      interval: 10s
      timeout: 5s
      retries: 5
    environment:
      - MONGO_INITDB_ROOT_USERNAME=admin
      - MONGO_INITDB_ROOT_PASSWORD=pass
    volumes:
      - mongo1_data:/data/db
  mongo2:
    image: mongo:7.0
    hostname: mongo2
    command: mongod --replSet rs0 --bind_ip_all --port 27017
    # ... 同样的 healthcheck、env、volumes 配置
  mongo3:
    image: mongo:7.0
    hostname: mongo3
    command: mongod --replSet rs0 --bind_ip_all --port 27017
    # ... 同样配置
volumes:
  mongo1_data: {}
  mongo2_data: {}
  mongo3_data: {}

--bind_ip_all 必须显式写上，否则 mongod 默认只监听 127.0.0.1，容器之间根本无法互通。另外，不要在 command 里加 --auth——这会在初始化阶段阻止无认证连接，导致健康检查和初始化脚本全部失败。正确的顺序是先建好副本集，再通过 db.createUser() 开启权限控制。还有，每个数据卷名称必须唯一，如果多个服务共用同一个 volume，数据状态会乱成一团。网络方面，Docker 默认的 bridge 网络不支持容器名解析，所以一定要使用自定义网络（或者在 docker-compose.yml 里显式声明 networks），否则节点之间无法互相发现。这些都是 Docker 副本集配置注意事项。

初始化脚本怎么写才能一次成功？单独写一个 init-replica.sh，通过 volume 挂载到 mongo1 容器中，然后在 entrypoint 中调用。核心逻辑是：使用 until 循环配合 mongosh --eval 检查 mongo2 和 mongo3 是否响应，超时时间设为 60 秒。确认所有节点就绪后，执行如下命令初始化：

rs.initiate({
  _id: "rs0",
  members: [
    { _id: 0, host: "mongo1:27017" },
    { _id: 1, host: "mongo2:27017" },
    { _id: 2, host: "mongo3:27017" }
  ]
})

执行完后立即调用 rs.conf() 确认 members 数量和状态都正确。如果后续想添加读写分离的从节点或仲裁节点，必须使用 rs.add()，千万别再去执行 rs.initiate()——那会清空已有配置，相当于重建整个副本集。遵循这些 MongoDB 副本集扩展方法，可以避免很多坑。

事务支持本身不需要额外配置，只要副本集状态正常、写关注设置为 majority，客户端里开启 session 就自动支持了。最容易忽略的反而是最后一步：初始化完成后，应用连接的地址还停留在单机地址，必须改成 mongodb://mongo1:27017,mongo2:27017,mongo3:27017/?replicaSet=rs0 这种多节点连接字符串，否则事务可能不会被正确路由到主节点。这个复制集连接字符串的配置是 MongoDB 事务支持生效的关键。