Docker Compose部署MongoDB容器正常但UI工具无法连接（超时/认证失败）

通过Docker Compose部署的MongoDB容器内部可正常使用mongosh操作数据（已创建测试库JobDB、集合并插入数据），但外部使用VS Code MongoDB扩展、MongoDB Compass等UI工具连接时失败，出现超时或认证错误，且容器状态显示为unhealthy。

相关配置与状态信息 #

docker-compose.yml配置 #

mongodb:
    image: mongo:latest
    environment:
      MONGO_INITDB_ROOT_USERNAME: root
      MONGO_INITDB_ROOT_PASSWORD: example
    ports:
      - "27017:27017"
    healthcheck:
      test: ["CMD", "mongo", "--eval", "db.adminCommand('ping')"]
      interval: 10s
      retries: 5
      start_period: 5s
    restart: always
    volumes:
      - mongodb-data:/data/db

容器内mongosh查询结果 #

admin> show dbs
JobDB   432.00 KiB << 测试数据库，包含集合与数据
admin   100.00 KiB
config  108.00 KiB
local    72.00 KiB

docker ps输出（容器状态为unhealthy） #

CONTAINER ID   IMAGE                  COMMAND                   CREATED          STATUS                      PORTS                               NAMES
...
f4ad04c6de18   mongo:latest           "docker-entrypoint.s…"   48 minutes ago   Up 48 minutes (unhealthy)   0.0.0.0:27017->27017/tcp            automation-mongodb-1

docker network ls输出 #

NETWORK ID     NAME                         DRIVER    SCOPE
f45e66a2be2e   automation_default           bridge    local

问题排查与解决步骤 #

1. 修复健康检查失败问题 #

容器显示unhealthy是因为健康检查命令使用了旧版的mongo客户端，新版MongoDB（6.0+）已默认使用mongosh，且需要携带认证信息才能执行ping命令。修改docker-compose.yml中的healthcheck配置：

healthcheck:
  test: ["CMD", "mongosh", "--eval", "db.adminCommand('ping')", "--username", "root", "--password", "example", "--authenticationDatabase", "admin"]
  interval: 10s
  retries: 5
  start_period: 10s

修改后重启容器：

docker-compose up -d --force-recreate mongodb

2. 确保外部连接的认证参数正确 #

外部UI工具连接时必须指定完整的认证信息：

• 标准连接字符串：mongodb://root:example@localhost:27017/?authSource=admin
• 核心注意点：必须显式指定authSource=admin，因为root用户是在admin库下初始化的
• 若使用容器IP连接，先通过以下命令获取容器IP：

docker inspect automation-mongodb-1 | grep "IPAddress"

再将连接字符串中的localhost替换为容器IP

3. 检查端口映射与防火墙状态 #

• 确认宿主机27017端口未被其他进程占用：

netstat -tulpn | grep 27017

• 临时关闭宿主机防火墙或添加端口放行规则（以Ubuntu的ufw为例）：

sudo ufw allow 27017

4. 验证MongoDB绑定地址（可选） #

默认情况下MongoDB容器会绑定0.0.0.0允许所有IP访问，若需确认可进入容器查看配置：

docker exec -it automation-mongodb-1 bash
cat /etc/mongod.conf.orig | grep bindIp

若结果为bindIp: 127.0.0.1，需在docker-compose.yml中添加命令参数修改绑定地址：

command: mongod --bind_ip_all

之后重启容器即可。

内容的提问来源于stack exchange，提问作者Dr.Dan