Docker Compose部署MongoDB与Mongo-express时认证连接失败问题

你的问题核心是MongoDB的root用户未被正确创建，原因是MONGO_INITDB_ROOT_USERNAME和MONGO_INITDB_ROOT_PASSWORD这两个环境变量仅在MongoDB首次初始化（即/data/db目录为空）时生效。你当前挂载了本地数据卷./docker/nosql/mongo/data，如果这个目录之前已有数据，初始化脚本不会重新执行，自然不会创建root用户。

以下是具体解决步骤：

步骤1：清理旧数据卷（最直接解决方法） #

停止并删除现有容器：

docker-compose down

删除本地挂载的数据目录（清除旧数据，让MongoDB重新初始化）：

rm -rf ./docker/nosql/mongo/data ./docker/nosql/mongo/dbconfig

重新启动容器：

docker-compose up -d

此时MongoDB会重新执行初始化流程，自动创建admin数据库下的root用户。

步骤2：优化Docker Compose配置（避免启动顺序问题） #

添加MongoDB的健康检查，确保mongo-express只在MongoDB完全就绪后再启动，修改后的配置如下：

services:
  mongo:
    image: mongo:latest
    restart: on-failure
    container_name: mongo
    environment:
      MONGO_INITDB_ROOT_USERNAME: root
      MONGO_INITDB_ROOT_PASSWORD: PassW0rd
    ports:
      - 27017:27017
    volumes:
      - ./docker/nosql/mongo/data:/data/db
      - ./docker/nosql/mongo/dbconfig:/data/configdb
    healthcheck:
      test: ["CMD", "mongosh", "--eval", "db.adminCommand('ping')", "--username", "root", "--password", "PassW0rd", "--authenticationDatabase", "admin"]
      interval: 10s
      timeout: 5s
      retries: 5

  mongo-express:
    image: mongo-express
    restart: always
    ports:
      - 8888:8081
    container_name: mongo-express
    environment:
      ME_CONFIG_MONGODB_SERVER: mongo
      ME_CONFIG_MONGODB_ENABLE_ADMIN: true
      ME_CONFIG_MONGODB_ADMINUSERNAME: root
      ME_CONFIG_MONGODB_ADMINPASSWORD: PassW0rd
    depends_on:
      mongo:
        condition: service_healthy

步骤3：验证用户创建结果 #

进入MongoDB容器，手动检查root用户是否存在：

docker exec -it mongo mongosh -u root -p PassW0rd --authenticationDatabase admin

在MongoShell中执行以下命令查看用户：

use admin
db.getUsers()

如果输出结果包含root用户，则说明初始化成功。

内容的提问来源于stack exchange，提问作者Việt Tùng Nguyễn