Flask连MongoDB失败八成因MONGO_URI配置错误或PyMongo初始化顺序不当：必须先创建app、再配置MONGO_URI、最后传app初始化PyMongo；URI需含正确前缀、参数及URL编码，且不可在模块顶层调用mongo.db。
Flask 连 MongoDB 失败，八成是 MONGO_URI 配错了，或者 PyMongo 初始化顺序不对——不是代码写得不够多，而是关键几步没踩准。
PyMongo 初始化必须在 app 配置之后
常见错误是把 PyMongo(app) 写在 app.config['MONGO_URI'] = ... 前面，或者更糟：写在模块顶层（函数外），导致 Flask 应用上下文还没建立就去访问 mongo.db。
- ✅ 正确顺序：
app = Flask(__name__)→app.config['MONGO_URI'] = os.getenv("MONGO_URI", "mongodb://localhost:27017/myapp")→mongo = PyMongo(app) - ❌ 错误写法：
mongo = PyMongo(app, uri="mongodb://...")—— 显式传uri=会绕过配置系统，环境变量失效 - ❌ 模块级调用：
mongo.db.users.find_one({})写在函数外，启动时直接报RuntimeError: Working outside of application context
MONGO_URI 格式必须严格匹配场景
URI 少一个字符、多一个斜杠、漏掉 mongodb:// 前缀，都可能静默失败或抛 ConnectionFailure，而不是明确提示你哪错了。
- 本地开发：
"mongodb://localhost:27017/myapp"—— 注意末尾是数据库名，不是路径 - Docker 容器内连接其他服务：
"mongodb://mongo:27017/myapp"（mongo是 docker-compose 中的服务名） - MongoDB Atlas：
"mongodb+srv://user:pass@cluster.mongodb.net/myapp?retryWrites=true&w=majority"——?retryWrites=true&w=majority缺一不可，否则写入可能不持久 - 密码含特殊字符？必须用
urllib.parse.quote_plus()编码后再拼进 URI，否则连接被截断
连接后查不到数据？先确认三件事
插入成功但 find() 返回空，往往不是连不上，而是查的方式不对。
- 集合是否真实存在？运行
mongo.db.list_collection_names()看返回里有没有你写的集合名（注意大小写和拼写，users≠Users） -
_id查询要转类型：传字符串"507f1f77bcf86cd799439011"不行，得用ObjectId("507f1f77bcf86cd799439011") - 插入后立刻查，别忘了检查
result.acknowledged和result.inserted_id，避免网络延迟导致你以为没写进去 - 默认不自动创建索引，高频查询字段（比如
email）记得手动建：mongo.db.users.create_index("email", unique=True)
别在每次请求里新建 MongoClient
PyMongo 实例本身已封装了带连接池的 pymongo.MongoClient，全局复用即可。重复初始化不仅慢，还会快速耗尽服务器连接数限制。
- 需要访问同集群下另一个数据库？用
mongo.cx["other_db"]，别 new 一个新 client - 想换数据库名做灰度测试？改
MONGO_URI中的路径部分（如/myapp_staging），而不是重建PyMongo实例 - 工厂模式（
create_app()）下，确保PyMongo是在appreturn 之前完成初始化和绑定的
最容易被忽略的是：URI 中的数据库名只是默认操作库，mongo.db 指向它，但你随时能用 mongo.cx["another_db"] 切过去——这个能力常被当成“不支持多库”而错过，其实根本不用重连。
