Docker部署的mongo-express无法通过本地端口访问问题求助

问题描述 #

我是Docker新手，尝试部署MongoDB和mongo-express，执行了以下命令：

docker network create mongo-network
docker run -d -p 27017:27017 -e MONGO_INITDB_ROOT_USERNAME=admin -e MONGO_INITDB_ROOT_PASSWORD=password --network mongo-network --name mongodb mongo
docker run -d -p 8081:8081 -e ME_CONFIG_MONGODB_ADMINUSERNAME=admin -e ME_CONFIG_MONGODB_ADMINPASSWORD=password -e ME_CONFIG_MONGODB_SERVER=mongodb --network mongo-network --name mongo-express mongo-express

所有命令执行无报错，但查看mongo-express日志发现连接MongoDB失败：

> docker logs b44b
Waiting for mongo:27017...
/docker-entrypoint.sh: line 15: mongo: Try again
/docker-entrypoint.sh: line 15: /dev/tcp/mongo/27017: Invalid argument
Wed Dec 18 11:23:37 UTC 2024 retrying to connect to mongo:27017 (2/10)
/docker-entrypoint.sh: line 15: /dev/tcp/mongo/27017: Invalid argument
No custom config.js found, loading config.default.js
Welcome to mongo-express 1.0.2
------------------------
Mongo Express server listening at http://0.0.0.0:8081
Server is open to allow connections from anyone (0.0.0.0)
basicAuth credentials are "admin:pass", it is recommended you change this in your config.js!

虽然日志显示mongo-express在8081端口监听，但访问时提示：

This page isn’t working right now
localhost didn’t send any data.
ERR_EMPTY_RESPONSE

问题原因分析 #

• MongoDB连接失败是核心诱因：日志里反复出现连接mongo:27017失败的提示，虽然你通过ME_CONFIG_MONGODB_SERVER=mongodb指定了正确的数据库容器名，但mongo-express镜像自带的启动脚本可能写死了等待mongo这个主机名，导致前期连接校验失败。后续服务虽然启动，但实际运行时无法正常连接MongoDB，处理请求时无数据返回，最终出现ERR_EMPTY_RESPONSE。
• 端口映射有效性需排查：可以在本地执行对应命令验证端口是否被Docker容器占用：
  • Linux/macOS：lsof -i :8081
  • Windows：netstat -ano | findstr ":8081"
    如果端口未被占用，说明本地端口被其他程序抢占，导致容器端口映射失败。
• 默认基础认证可能被忽略：日志明确标注mongo-express默认的基础认证账号密码是admin:pass，若访问时未输入正确凭据，也可能引发异常，但ERR_EMPTY_RESPONSE更偏向服务无法处理请求，此为次要排查点。

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