docker-compose部署带MongoEngine的Flask应用时pymongo连接错误如何解决？

1. MongoEngine连接配置未读取环境变量：报错信息明确显示应用尝试连接localhost:27017，但docker-compose中已经给api容器注入了DB_HOST=mongodb的环境变量，说明Flask代码里MongoEngine的连接地址硬编码成了localhost，没有读取传入的DB_HOST环境变量，这是当前问题的核心原因。
2. mongodb容器启动延迟：docker-compose的depends_on仅保证容器启动顺序，不保证mongodb服务完全初始化完成就会启动api容器，mongodb未就绪时也会触发连接拒绝。
3. 认证数据库配置缺失：你使用的是MongoDB默认root用户，该用户默认创建在admin库下，如果MongoEngine配置没指定authSource为admin，地址连通后也会触发认证失败类错误。

• 第一步：修改MongoEngine连接配置
  检查Flask应用中MongoEngine初始化代码，改为读取环境变量，参考配置如下：

  import os
  from flask_mongoengine import MongoEngine
  
  db = MongoEngine()
  def init_db(app):
      app.config['MONGODB_SETTINGS'] = {
          'host': f"mongodb://{os.getenv('DB_USERNAME')}:{os.getenv('DB_PASSWORD')}@{os.getenv('DB_HOST', 'localhost')}:27017/你的业务库名?authSource=admin"
      }
      db.init_app(app)
  

• 第二步：添加mongodb服务健康检查，解决启动顺序问题
  修改docker-compose.yml配置，新增mongodb健康检测规则，同时调整api的启动依赖条件：

  mongodb:
    image: mongo
    container_name: mongodb
    command: mongod
    environment:
      - "MONGO_INITDB_ROOT_USERNAME=name"
      - "MONGO_INITDB_ROOT_PASSWORD=password"
    volumes:
      - dbdata:/data/db
    # 新增健康检查
    healthcheck:
      test: echo 'db.runCommand("ping").ok' | mongosh localhost:27017/test --quiet
      interval: 5s
      timeout: 5s
      retries: 5
  # 如果使用的MongoDB版本低于5.0，健康检查命令中的`mongosh`需替换为`mongo`
  
  api:
    build: api
    image: azurecr.io/api
    ports:
      - "5000:5000"
    environment:
      - "ENV=prod"
      - "DB_USERNAME=name"
      - "DB_PASSWORD=password"
      - "DB_HOST=mongodb"
    depends_on:
      mongodb:
        condition: service_healthy
  

• 第三步：验证配置生效
  执行命令重新构建启动容器：docker-compose up --build -d
  进入api容器执行env | grep DB_确认环境变量已正确注入，再执行ping mongodb确认容器间网络连通正常即可。

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