Docker Compose启动MongoDB后容器内连接认证失败问题排查

1. 数据卷残留旧数据导致初始化未执行 #

MongoDB的MONGO_INITDB_ROOT_USERNAME和MONGO_INITDB_ROOT_PASSWORD仅在首次启动且数据目录为空时才会创建root用户。如果之前启动过容器，挂载的数据卷里已经有旧的数据库文件，初始化脚本不会重新执行，新配置的账号密码自然不生效。

解决步骤：

• 停止并删除容器（同时清理数据卷）：docker compose down -v
• 重新启动容器：docker compose up -d

2. 连接时未指定认证数据库 #

root用户默认创建在admin数据库中，直接执行mongo -u admin -p会默认连接test数据库，导致认证失败。必须明确指定认证数据库：

执行以下命令连接：

mongo -u admin -p pass123 --authenticationDatabase admin

或者进入容器后分步操作：

mongo
use admin
db.auth("admin", "pass123")

3. 私有镜像自带初始化逻辑干扰 #

私有镜像可能内置了自定义初始化脚本（比如/docker-entrypoint-initdb.d/目录下的脚本），这些脚本可能覆盖或跳过了默认的root用户创建流程。

检查镜像内的初始化脚本：

docker exec -it mymongo ls /docker-entrypoint-initdb.d/

如果有自定义脚本，查看内容是否存在账号配置冲突，调整脚本确保先完成root用户认证，再执行后续数据库创建操作。

4. 修复service_configs数据库创建失败问题 #

日志显示创建该库时需要认证，说明执行创建操作的进程未用root账号认证。在创建数据库的脚本中先完成admin账号认证：

示例修复后的脚本逻辑：

// 先认证admin账号
db.getSiblingDB('admin').auth('admin', 'pass123');
// 再创建目标数据库
db.getSiblingDB('service_configs');

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