直接用 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 事务支持生效的关键。
