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 并赋值给模块变量看似简单，但极易出问题：

• 如果在模块顶层创建 client = MongoClient(...)，它会在应用导入时就建立连接——但此时配置可能还没加载（比如从环境变量或 .env 读取），导致 URI 错误或缺失
• 忘记设置 maxPoolSize 和 minPoolSize，高并发下连接耗尽，报错 Connection pool is full
• 没关连接？别关——MongoClient 是线程安全的单例，应长期存活；关了反而触发重建开销，client.close() 只应在进程退出前调用（如 atexit）
• 多个 MongoClient 实例（比如每个蓝本都 new 一个）会各自建池，浪费资源且难监控

连接字符串里的 authSource 和 replicaSet 必须显式指定

本地单机开发常忽略这些参数，一上生产就连不上：

Flask Wrap

火焰围攻 授权: q15040409-creator.功能概述火焰围攻 授权: q15040409-creator.是一项面向实际任务的技能，主要用于Description.；Flask Web. - Python.；核心要点HTTP?；.Version.1.0.tags. wrap.github.automation.。它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。使用与执行使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要

下载

• 用户在 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 日志级别

真正麻烦的从来不是“怎么连上”，而是连接何时建、谁来关、失败后怎么重试、多环境配置怎么隔离——这些细节不写进启动逻辑，上线后就会卡在凌晨三点查日志。