构建Mongo Docker镜像自动创建数据库用户，Dockerfile配置报错如何解决？

现有配置的错误原因 #

• 镜像构建阶段的RUN指令执行时，MongoDB服务进程mongod尚未启动，无法通过mongo客户端连接数据库执行操作，这也是你碰到报错的核心原因
• RUN mongo会启动交互式shell，镜像构建流程无法处理交互输入，会直接阻塞或抛出异常
• db.createUser语法存在错误：roles字段后缺少冒号，正确写法为roles: [{...}]
• 手动在构建阶段执行用户创建不符合官方Mongo镜像的初始化逻辑，即使临时启动mongod执行操作，数据也会被后续容器启动的入口脚本重置

正确实现方案 #

官方Mongo镜像预留了专属初始化脚本目录/docker-entrypoint-initdb.d/，存放在该目录下的.js/.sh脚本会在容器首次启动且数据卷未初始化时自动执行，完全匹配你的需求。

步骤1：新建数据库初始化脚本 #

在Dockerfile同级目录下创建init-user.js文件，内容如下：

use tewtdb
db.createUser({
  user: '<替换为实际用户名>',
  pwd: '<替换为实际密码>',
  roles: [{role: 'dbOwner', db: 'tewtdb'}]
})

步骤2：修改Dockerfile配置 #

FROM mongo:latest

# 将初始化脚本复制到官方指定的初始化目录
COPY init-user.js /docker-entrypoint-initdb.d/

EXPOSE 27017

# 若需要开启数据库权限校验，可使用下方CMD配置，否则保持默认即可
# CMD ["mongod", "--auth"]

启动注意事项 #

• 如果你之前已经启动过该容器生成了数据卷，需要先删除旧的匿名/命名数据卷，否则初始化脚本不会触发执行
• 若你仅需要创建超级管理员账号，无需编写自定义脚本，直接在启动容器时传入官方环境变量即可：

docker run -d \
  -e MONGO_INITDB_ROOT_USERNAME=admin \
  -e MONGO_INITDB_ROOT_PASSWORD=你的管理员密码 \
  -e MONGO_INITDB_DATABASE=tewtdb \
  -p 27017:27017 \
  mongo:latest --auth

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