Flask-PyMongo必须在应用实例创建后、路由注册前初始化，因其依赖应用上下文读取配置（如MONGO_URI）并注册teardown回调；在模块顶层或app创建前调用会因缺失app.context导致RuntimeError或AttributeError。
直接用 PyMongo 初始化即可，但必须在应用实例创建后、路由注册前完成，否则会报 Working outside of application context 错误。
为什么不能在模块顶层直接初始化 PyMongo？
Flask 的扩展（如 PyMongo）依赖应用上下文（app context）来读取配置、绑定连接池。如果在 app = Flask(__name__) 之前就调用 PyMongo()，它找不到 app.config['MONGO_URI']，也无法注册 teardown 回调 —— 最终导致运行时报错或连接泄漏。
- 常见错误现象：
RuntimeError: Working outside of application context或AttributeError: 'NoneType' object has no attribute 'db' - 典型误写：
mongo = PyMongo() # ❌ 没传 app，后续调用 mongo.db 会失败 app = Flask(__name__) app.config['MONGO_URI'] = 'mongodb://...'
- 正确顺序：先有
app，再配config，最后传给PyMongo(app)
PyMongo 初始化时要不要显式传 uri 参数？
推荐只通过 app.config['MONGO_URI'] 配置，不传 uri=... 参数。传参会绕过 Flask 的配置系统，导致无法使用环境变量动态切换数据库（比如开发用 localhost，生产用 mongodb+srv://...）。
- ✅ 推荐写法：
app.config['MONGO_URI'] = os.getenv('MONGO_URI', 'mongodb://localhost:27017/myapp') - ❌ 避免写法：
mongo = PyMongo(app, uri='mongodb://...') # 覆盖 config，难维护
- 注意：
MONGO_URI是唯一被识别的 key；写成MONGO_URL或MONGODB_URI都不会生效
如何支持多数据库或按需连接？
PyMongo 默认只连一个数据库（由 URI 中的路径部分决定，如 /myapp），但你可以用 mongo.cx 获取底层 pymongo.MongoClient 实例，手动访问其他库：
- 访问同集群下另一个库：
other_db = mongo.cx['another_db']
- 访问不同集合（无需额外配置）：
users = mongo.db.users posts = mongo.db.posts
- 不建议在每次请求中新建
MongoClient：它自带连接池，全局复用更高效；重复初始化会浪费资源并可能触发连接数限制
最易被忽略的一点：Flask-PyMongo 不自动处理连接失败重试，也**不校验 URI 格式是否合法**——你得自己在启动时加个健康检查，比如 mongo.db.command('ping')，否则上线后才发现连不上 MongoDB，服务就静默挂了。
