NestJS无法连接Docker容器内MongoDB的问题求助

1. 修正数据库连接地址 #

本地运行时用localhost/127.0.0.1没问题，但Docker容器间通信必须使用MongoDB服务的名称作为主机地址（docker-compose会自动解析服务名到对应容器IP）：

• 错误示例（Docker环境无效）：

  DATABASE_URL=mongodb://localhost:27017/your-db
  

• 正确示例（假设docker-compose中MongoDB服务名为mongodb）：

  DATABASE_URL=mongodb://mongodb:27017/your-db
  

2. 检查Docker Compose网络与挂载配置 #

• 确保API和MongoDB服务在同一网络：docker-compose默认会为所有服务创建共享网络，无需额外配置，除非你手动指定了不同网络
• 确认.env文件被正确挂载到API容器，避免容器内读取不到配置：

  services:
    api:
      volumes:
        - ./.env:/app/.env # 路径需匹配你的项目目录结构
    mongodb:
      image: mongo:latest
      # 其他配置...
  

3. 验证MongoDB容器状态与端口 #

• 执行docker-compose ps，确认mongodb服务状态为Up
• 注意：容器内部MongoDB默认用27017端口，即使docker-compose中配置了宿主机端口映射（比如27018:27017），API连接时仍用27017，不要用宿主机映射的端口

4. 排查MongoDB认证问题（若开启） #

• 如果MongoDB设置了账号密码，连接串需包含认证信息：

  DATABASE_URL=mongodb://root:example@mongodb:27017/your-db?authSource=admin
  

• 检查docker-compose中MongoDB的初始化环境变量是否正确：

  mongodb:
    environment:
      MONGO_INITDB_ROOT_USERNAME: root
      MONGO_INITDB_ROOT_PASSWORD: example
      MONGO_INITDB_DATABASE: your-db
  

5. 通过日志定位具体错误 #

• 查看API容器日志，获取连接失败的细节：

  docker-compose logs api
  

• 查看MongoDB容器日志，确认数据库是否正常初始化：

  docker-compose logs mongodb
  

6. 测试容器间网络连通性 #

进入API容器，ping MongoDB服务名验证网络可达：

docker-compose exec api ping mongodb

如果ping不通，检查网络配置；如果ping通但连接失败，重点排查连接串的端口、认证参数。

内容的提问来源于stack exchange，提问作者M.G.S SUPUNTHAKA