Docker中MongoDB副本集通过/docker-entrypoint-initdb.d/初始化报错咨询

为什么/docker-entrypoint-initdb.d/方式会报错？ #

错误Did not find local replica set configuration document at startup的核心原因是：MongoDB启动时没有以副本集模式运行——即使你在脚本里执行了rs.initiate()，重启或后续节点连接时，MongoDB无法识别自身属于副本集，找不到对应的配置文档。

常见操作误区 #

• 未指定副本集启动参数：/docker-entrypoint-initdb.d/的脚本仅在MongoDB初始化阶段执行，但如果启动容器时没有加--replSet <副本集ID>参数，MongoDB默认以单实例模式运行。即使脚本执行了初始化，后续容器重启后，MongoDB还是会以单实例启动，自然找不到副本集配置。
• 脚本执行时机限制：该目录下的脚本只在第一次初始化空数据卷时运行，如果之前已经有数据（比如之前手动启动过容器），脚本不会再次执行，导致副本集配置未初始化。
• 脚本未等待MongoDB就绪：如果脚本执行过快，MongoDB还没完全启动完成，rs.initiate()会执行失败，无法生成副本集配置文档。

正确的/docker-entrypoint-initdb.d/配置步骤 #

1. 启动容器时指定副本集模式 #

无论用docker run还是docker-compose，必须在启动命令中加入--replSet参数，对应你的副本集ID：

Docker Run 示例：

docker run -d --name mongo-host1 \
  -v mongo-data1:/data/db \
  -v ./init-rs.js:/docker-entrypoint-initdb.d/init-rs.js \
  mongo:5.0 \
  --replSet replicaset

Docker Compose 示例：

version: '3'
services:
  mongo-host1:
    image: mongo:5.0
    volumes:
      - mongo-data1:/data/db
      - ./init-rs.js:/docker-entrypoint-initdb.d/init-rs.js
    command: --replSet replicaset
  mongo-host2:
    image: mongo:5.0
    volumes:
      - mongo-data2:/data/db
    command: --replSet replicaset
  mongo-host3:
    image: mongo:5.0
    volumes:
      - mongo-data3:/data/db
    command: --replSet replicaset
volumes:
  mongo-data1:
  mongo-data2:
  mongo-data3:

2. 编写可靠的初始化脚本 #

创建init-rs.js文件，确保等待MongoDB就绪后再执行初始化，同时指定完整的主机地址（包含端口）：

// 等待MongoDB服务就绪
function waitForMongoReady() {
  while (true) {
    try {
      var status = rs.status();
      if (status.ok) break;
    } catch (e) {
      print("Waiting for MongoDB to be ready...");
      sleep(1000);
    }
  }
}

waitForMongoReady();

rs.initiate({
 _id: "replicaset",
 members: [
   {_id: 0, host: "mongo-host1:27017"},
   {_id: 1, host: "mongo-host2:27017"},
   {_id: 2, host: "mongo-host3:27017"}
 ]
});

// 等待副本集初始化完成
while (!rs.isMaster().ismaster) {
  print("Waiting for replica set to initialize...");
  sleep(1000);
}

print("Replica set initialized successfully!");

注意：主机名要和容器名/服务名一致，确保节点间能互相通信。

关于配置文件的使用 #

如果想用配置文件代替命令行参数，MongoDB容器默认的配置文件路径是/etc/mongod.conf，你可以将自定义配置文件挂载到该路径：

自定义mongod.conf示例： #

storage:
  dbPath: /data/db
  journal:
    enabled: true
replication:
  replSetName: "replicaset"
net:
  port: 27017
  bindIp: 0.0.0.0

启动容器时挂载配置文件： #

docker run -d --name mongo-host1 \
  -v ./mongod.conf:/etc/mongod.conf \
  -v mongo-data1:/data/db \
  -v ./init-rs.js:/docker-entrypoint-initdb.d/init-rs.js \
  mongo:5.0 \
  -f /etc/mongod.conf

额外注意事项 #

• 清理旧数据：如果之前已经启动过容器并生成了数据卷，需要先删除数据卷（docker volume rm <volume-name>），确保脚本能重新执行初始化。
• 节点通信：确保所有副本集节点之间能通过主机名/IP访问27017端口，docker-compose环境下服务名默认可以互相解析。

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