使用Docker Compose的Flask应用无法连接MongoDB：ServerSelectionTimeoutError

你的核心矛盾是：已确认Flask应用的MONGO_URI配置为mongodb://mongo:27017/mylibrary，但实际连接时仍指向localhost:27017，以下是最可能的原因及对应解决方法：

1. 数据库扩展初始化未正确读取Flask配置 #

如果使用Flask-MongoEngine或直接调用pymongo，可能存在硬编码连接字符串或初始化逻辑错误：

• 检查extensions.py，如果存在提前创建MongoClient的代码（如下），会覆盖Flask配置：

# 错误示例：硬编码localhost
from pymongo import MongoClient
client = MongoClient("mongodb://localhost:27017")

• 正确的做法是依赖Flask配置初始化：
  • 若用Flask-MongoEngine：

    from flask_mongoengine import MongoEngine
    db = MongoEngine()  # 仅初始化实例，不提前连接
    

    后续db.init_app(app)会自动读取app.config['MONGO_URI']。
  • 若直接用pymongo，需从Flask配置获取URI：

    from flask import current_app
    from pymongo import MongoClient
    
    def get_db():
        client = MongoClient(current_app.config['MONGO_URI'])
        return client.get_default_database()
    

2. depends_on不保证MongoDB完全就绪 #

Docker Compose的depends_on仅控制容器启动顺序，不代表MongoDB服务已完成初始化可接受连接，此时应用会因连接失败 fallback 到硬编码的localhost（若代码中有相关逻辑）。

• 解决方法：
  1. 给MongoDB添加健康检查，让backend仅在数据库就绪后启动：
     修改docker-compose.yml：

     services:
       mongo:
         image: mongo
         ports:
           - "27017:27017"
         healthcheck:
           test: ["CMD", "mongosh", "--eval", "db.adminCommand('ping')"]
           interval: 5s
           timeout: 5s
           retries: 5
       backend:
         build: ./backend
         ports:
           - "5000:5000"
         depends_on:
           mongo:
             condition: service_healthy
         environment:
           MONGODB_URI: "mongodb://mongo:27017/mylibrary"
     

  2. 给Flask应用添加连接重试逻辑，避免启动时连接失败：

     from pymongo import MongoClient
     from pymongo.errors import ServerSelectionTimeoutError
     import time
     
     def init_db(app):
         uri = app.config['MONGO_URI']
         max_retries = 5
         retry_delay = 2
         for _ in range(max_retries):
             try:
                 client = MongoClient(uri)
                 client.admin.command('ping')  # 测试连接
                 app.db = client.get_default_database()
                 return
             except ServerSelectionTimeoutError:
                 time.sleep(retry_delay)
         raise Exception("多次重试后仍无法连接MongoDB")
     

3. 代码中存在隐藏的硬编码连接 #

虽然你打印了MONGO_URI正确，但可能在其他模块（如路由、工具类）中存在硬编码的localhost连接，例如：

# 某路由文件中的错误代码
client = MongoClient("mongodb://localhost:27017")

• 解决方法：全局搜索代码中的localhost:27017或mongodb://localhost，替换为从Flask配置读取。

4. Docker镜像缓存导致旧代码未更新 #

即使你重新构建镜像，Docker可能复用了旧的缓存层，导致修改后的配置代码未生效。

• 解决方法：强制重新构建镜像：

docker-compose build --no-cache backend
docker-compose up -d

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