MongoDB副本集Docker容器认证失败：无法找到root用户

1. 副本集初始化与用户创建顺序冲突 #

MongoDB官方镜像的MONGO_INITDB_ROOT_USERNAME和MONGO_INITDB_ROOT_PASSWORD仅在首次启动且数据目录为空时触发初始化脚本创建root用户。如果启动时直接开启认证+副本集，可能出现副本集未就绪就触发认证，导致初始化脚本无法正常写入用户数据。

解决方法：调整启动流程 #

在自定义entrypoint中先启动不带认证的mongod，完成副本集初始化和用户创建后，再启动带认证的服务：

# 临时启动无认证的mongod
mongod --port 27017 --dbpath /data/db --bind_ip_all &
MONGO_TEMP_PID=$!

# 等待服务就绪
sleep 5

# 初始化副本集
mongosh --port 27017 --eval 'rs.initiate({_id: "rs0", members: [{_id: 0, host: "localhost:27017"}]})'

# 确保副本集主节点就绪后，手动创建root用户（若环境变量未自动执行）
mongosh --port 27017 --eval "db.getSiblingDB('admin').createUser({user: '$MONGO_INITDB_ROOT_USERNAME', pwd: '$MONGO_INITDB_ROOT_PASSWORD', roles: ['root']})"

# 关闭临时mongod
kill $MONGO_TEMP_PID
wait $MONGO_TEMP_PID

# 启动带认证和密钥文件的正式服务
exec mongod --auth --replSet rs0 --keyFile /path/to/your/keyfile --bind_ip_all

2. 密钥文件权限不符合要求 #

MongoDB副本集密钥文件必须满足：

• 权限严格为600（仅所有者可读可写）
• 所有者为容器内的mongodb用户

修复权限（在entrypoint中添加）： #

chown mongodb:mongodb /path/to/your/keyfile
chmod 600 /path/to/your/keyfile

注意：所有副本集节点必须使用完全相同的密钥文件内容，否则会导致节点无法加入副本集。

3. 连接命令未指定副本集与认证库 #

连接副本集时，必须明确指定副本集名称，且确保认证库为admin（root用户默认创建在此库）。

正确的连接命令： #

docker exec mongo mongosh "mongodb://root:rootpassword@localhost:27017/?authSource=admin&replicaSet=rs0"

或者分步指定参数：

docker exec mongo mongosh -u root -p rootpassword --authenticationDatabase admin --replSet rs0

4. 旧数据残留导致初始化脚本未执行 #

如果之前启动过容器，数据目录已有数据，MONGO_INITDB_*环境变量不会重复执行。需要清空数据目录或数据卷：

# 删除旧容器
docker rm -f mongo
# 清空命名数据卷（若使用）
docker volume rm mongo-data
# 重新启动容器
docker run ...（你的完整启动命令）

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