Flask 本身不内置 MongoDB 支持，必须用 pymongo 或 flask-pymongo；连接管理的关键是复用、生命周期对齐请求、避免泄漏，flask-pymongo 初始化并注入 app 是最轻量且符合 Flask 风格的做法，自动处理连接复用和请求上下文绑定，比裸用 pymongo.MongoClient 更安全。
Flask 本身不内置 MongoDB 支持，必须用 pymongo 或 flask-pymongo；连接管理的关键不是“手动 new client”，而是复用、生命周期对齐请求、避免泄漏。
用 flask-pymongo 初始化并注入 app
这是最轻量且符合 Flask 风格的做法。它自动处理连接复用和请求上下文绑定，比裸用 pymongo.MongoClient 更安全。
-
flask-pymongo会在第一次访问mongo.db时懒初始化连接，且默认启用连接池（maxPoolSize=100） - 配置必须在
app.config中设MONGO_URI，格式为mongodb://[user]:[pass]@[host]:[port]/[db]；带认证时不能省略--authenticationDatabase参数，例如：mongodb://todo:towait.com@localhost:27017/todolist?authSource=todolist - 调用
mongo.init_app(app)后，全局可直接用mongo.db.集合名，无需每次client.get_database()
pymongo.MongoClient 手动管理连接池的常见错误
直接 new MongoClient 并赋值给模块变量看似简单，但极易出问题：
Flask Wrap
下载
火焰围攻 授权: q15040409-creator.功能概述火焰围攻 授权: q15040409-creator.是一项面向实际任务的技能，主要用于Description.；Flask Web. - Python.；核心要点HTTP?；.Version.1.0.tags. wrap.github.automation.。它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。使用与执行使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要
- 如果在模块顶层创建
client = MongoClient(...)，它会在应用导入时就建立连接——但此时配置可能还没加载（比如从环境变量或.env读取），导致 URI 错误或缺失 - 忘记设置
maxPoolSize和minPoolSize，高并发下连接耗尽，报错Connection pool is full - 没关连接？别关——
MongoClient是线程安全的单例，应长期存活；关了反而触发重建开销，client.close()只应在进程退出前调用（如atexit） - 多个
MongoClient实例（比如每个蓝本都 new 一个）会各自建池，浪费资源且难监控
连接字符串里的 authSource 和 replicaSet 必须显式指定
本地单机开发常忽略这些参数，一上生产就连不上：
- 用户在
admin库创建，但数据库是todolist→ 连接串必须加?authSource=admin，否则认证失败 - 用 MongoDB Atlas 或副本集部署 → 必须加
?replicaSet=atlas-xxx-shard-0和&readPreference=primary，否则写操作可能路由到只读节点 - SSL 默认开启（Atlas 强制），本地测试若关 SSL 需加
&ssl=false&tlsAllowInvalidCertificates=true，但仅限开发环境
Flask 请求周期内如何安全使用连接
用 flask-pymongo 时，只要不在 before_first_request 或后台线程里提前访问 mongo.db，基本不会出错；但要注意：
- 不要在
@app.before_request里做mongo.db.xxx.find_one(...)—— 如果查询失败，整个请求会 500，且错误难以捕获 - 聚合管道、大批量写入（
insert_many）建议设timeout参数，例如mongo.db.coll.find(..., no_cursor_timeout=True)要慎用，易占满连接 - 调试时想看实际执行的命令？启用
logging：在连接串后加&serverMonitoringMode=stream并监听pymongo日志级别
真正麻烦的从来不是“怎么连上”，而是连接何时建、谁来关、失败后怎么重试、多环境配置怎么隔离——这些细节不写进启动逻辑，上线后就会卡在凌晨三点查日志。
