Mongo Express已监听但数据库未连接，登录验证失败求助

操作步骤 #

• 创建自定义网络：

  docker network create mongo-network
  

  执行docker network ls确认网络创建成功。
• 启动MongoDB容器：

  docker run -d \
  -p 27017:27017 \
  -e MONGO_INITDB_ROOT_USERNAME=admin \
  -e MONGO_INITDB_ROOT_PASSWORD=password \
  --name mongodb \
  --net mongo-network \
  mongo
  

• 启动Mongo Express容器：

  docker run -d \
  -p 8081:8081 \
  -e ME_CONFIG_MONGODB_ADMINUSERNAME=admin \
  -e ME_CONFIG_MONGODB_ADMINPASSWORD=password \
  --net mongo-network \
  --name mongo-express \
  -e ME_CONFIG_MONGODB_SERVER=mongodb \
  mongo-express
  

问题现象 #

1. 启动Mongo Express容器后，未出现预期的日志输出：

   Database Connected
   Admin Database connected
   

2. 访问localhost:8081时，登录界面不接受设置的账号密码，仅刷新页面无错误提示。
3. 已确认：docker ps显示两个容器均正常运行；docker network inspect mongo-network显示两个容器已加入目标网络。

可能的原因及解决方法 #

1. MongoDB容器未完全初始化就启动Mongo Express #

MongoDB初始化需要一定时间，若Mongo Express提前发起连接请求，会导致连接失败。

• 解决方法：
  1. 停止并删除Mongo Express容器：

     docker stop mongo-express && docker rm mongo-express
     

  2. 等待1-2分钟，确认MongoDB容器初始化完成后，重新启动Mongo Express容器。

2. 环境变量配置不匹配 #

检查Mongo Express的环境变量是否与MongoDB的初始化配置完全一致：

• 确认ME_CONFIG_MONGODB_SERVER设置为MongoDB容器名称mongodb（自定义网络内可通过容器名直接访问）。
• 确认ME_CONFIG_MONGODB_ADMINUSERNAME、ME_CONFIG_MONGODB_ADMINPASSWORD与MongoDB的MONGO_INITDB_ROOT_USERNAME、MONGO_INITDB_ROOT_PASSWORD完全匹配，注意大小写、空格及特殊字符。

3. 查看容器日志定位具体错误 #

通过日志获取连接失败的详细原因：

• 查看Mongo Express容器日志：

  docker logs mongo-express
  

  日志会明确显示连接失败的原因（如认证错误、网络超时等）。
• 查看MongoDB容器日志，确认初始化流程是否正常：

  docker logs mongodb
  

4. 版本兼容性问题 #

不同版本的MongoDB与Mongo Express可能存在认证机制或API兼容性冲突，例如新版MongoDB默认启用SCRAM-SHA-256认证，旧版Mongo Express可能不支持。

• 解决方法：指定兼容的版本组合，例如：

  # 启动MongoDB 4.4
  docker run -d \
  -p 27017:27017 \
  -e MONGO_INITDB_ROOT_USERNAME=admin \
  -e MONGO_INITDB_ROOT_PASSWORD=password \
  --name mongodb \
  --net mongo-network \
  mongo:4.4
  
  # 启动对应版本的Mongo Express
  docker run -d \
  -p 8081:8081 \
  -e ME_CONFIG_MONGODB_ADMINUSERNAME=admin \
  -e ME_CONFIG_MONGODB_ADMINPASSWORD=password \
  --net mongo-network \
  --name mongo-express \
  -e ME_CONFIG_MONGODB_SERVER=mongodb \
  mongo-express:0.54.0
  

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