Mongo-express Docker容器无法启动问题排查求助

1. 核对MongoDB容器名称与mongo-express配置匹配 #

• 确保mongo-express的ME_CONFIG_MONGODB_SERVER环境变量值和MongoDB容器的名称完全一致。比如你的MongoDB容器名为mongodb，启动mongo-express时必须指定-e ME_CONFIG_MONGODB_SERVER=mongodb，而非默认的mongo。
• 示例启动命令（假设专用网络名为mongo-net，MongoDB容器名mongodb）：

docker run -d \
  --name mongo-express \
  --network mongo-net \
  -p 8081:8081 \
  -e ME_CONFIG_MONGODB_SERVER=mongodb \
  mongo-express:0.54.0

2. 检查MongoDB认证与mongo-express的对应配置 #

• 如果你的MongoDB容器启动时设置了MONGO_INITDB_ROOT_USERNAME和MONGO_INITDB_ROOT_PASSWORD（启用管理员认证），mongo-express必须同步配置对应账号密码：

docker run -d \
  --name mongo-express \
  --network mongo-net \
  -p 8081:8081 \
  -e ME_CONFIG_MONGODB_SERVER=mongodb \
  -e ME_CONFIG_MONGODB_ADMINUSERNAME=你的MongoDB管理员用户名 \
  -e ME_CONFIG_MONGODB_ADMINPASSWORD=你的MongoDB管理员密码 \
  mongo-express:0.54.0

3. 更换稳定版mongo-express镜像 #

• 部分latest版本的mongo-express镜像可能存在entrypoint脚本的网络检测bug，尝试使用指定稳定tag的镜像（比如0.54.0），规避版本兼容性问题。

4. 验证容器内部网络环境 #

• 进入mongo-express容器内部，手动测试DNS解析和端口连通性：

# 进入运行中的mongo-express容器（若未退出）
docker exec -it mongo-express sh
# 解析MongoDB容器名称
nslookup mongodb
# 测试端口连通性
nc -zv mongodb 27017

若解析失败，说明容器网络配置有误，重新检查--network参数是否正确指向专用网络。

5. 重置Docker网络缓存（最后尝试） #

• 若以上步骤无效，重启Docker服务清除DNS缓存：

# Linux系统
sudo systemctl restart docker
# Windows/macOS
# 在Docker Desktop界面点击重启按钮

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