如何为本地及Docker应用定义通用的MongoClient连接？

API 探路者

2026-5-11

兼容本地与Docker环境的MongoDB连接方案

这是个很常见的跨环境配置问题，我给你几个简洁的解决方案，既能兼容本地开发，又能顺畅跑在Docker里：

方法1：带默认值的环境变量（推荐）

利用os.getenv()的默认值特性，让代码在本地自动使用localhost，在Docker环境下读取指定的数据库地址：

import os
from pymongo import MongoClient

# 优先读取环境变量MONGO_HOST，本地未设置时默认用localhost
mongo_host = os.getenv("MONGO_HOST", "localhost")
client = MongoClient(mongo_host, 27017)

为什么管用？

本地开发：因为你没设置MONGO_HOST环境变量，代码会自动用默认值localhost，和你原来的写法效果完全一致。
Docker环境：你只需要在启动容器时传入数据库地址的环境变量即可。比如：
- 用docker run启动：docker run -e MONGO_HOST=mongodb your-flask-image（这里的mongodb如果是Docker Compose里的服务名，容器之间可以直接通过服务名通信）
- 用Docker Compose的话，直接在docker-compose.yml里配置：
```
services:
  flask-app:
    build: .
    environment:
      - MONGO_HOST=mongodb
    depends_on:
      - mongodb
  mongodb:
    image: mongo:latest
```

方法2：用完整的MongoDB连接字符串（更灵活）

如果后续需要添加用户名、密码或者其他连接参数，用完整的URI格式会更方便，同样带默认值：

import os
from pymongo import MongoClient

# 默认使用本地连接字符串，Docker环境下通过环境变量覆盖
mongo_uri = os.getenv("MONGO_URI", "mongodb://localhost:27017/")
client = MongoClient(mongo_uri)

这种方式的优势是扩展性更强，比如以后要加认证，直接修改环境变量里的URI为mongodb://user:pass@mongodb:27017/dbname即可，代码完全不用改。