连不上 mongodb 主因是 pymongo 初始化时机错误或 mongo_uri 格式不合法：需确保在 flask 应用配置完成后初始化，uri 必须含正确前缀、数据库名及必要参数（如 retrywrites）。
连不上 MongoDB，八成是 PyMongo 初始化时机或 MONGO_URI 格式错了——不是代码写得不对，而是 Flask 应用上下文没就绪，或者 URI 少了个斜杠、漏了 mongodb:// 前缀。
Flask 中 PyMongo 初始化顺序错在哪
常见错误现象：RuntimeError: Working outside of application context 或 AttributeError: 'PyMongo' object has no attribute 'db'。根本原因是 PyMongo 实例在 Flask 应用配置完成前就被创建了。
- 别在
app = Flask(__name__)之前调用PyMongo(app)，此时app.config还没加载，MONGO_URI可能为空或无效 - 别把
mongo.db.users.find_one(...)写在模块顶层（函数外），那会在 import 时立即执行，早于应用启动 - 如果用了工厂函数
create_app()，确保mongo = PyMongo(app)出现在app.config.from_object(...)之后、app.register_blueprint(...)之前
MONGO_URI 字符串怎么写才不静默失败
URI 错一个字符（比如少 /、多空格、未 URL 编码密码）就会连接超时或静默失败，而不是报明确错误。
python-docx Skill功能概述python-docx Skill是一项面向实际任务的技能，主要用于本Skill提供使用python-docx生成专业Word文档的标准方法和最佳实践；生成安全服务方案文档；核心要点生成技术架构设计文档；生成任何需要专业排版的Word文档；核心库 : python-docx；使用与执行辅助库 : docx.shared , docx.enum , docx.oxml.ns；标准代码模板；1. 文档初始化；2. 字体设置（必须！它将相关步骤、工具调用和结果整理方式集
- 本地开发：必须带
mongodb://前缀，末尾是数据库名，不是路径 ——"mongodb://localhost:27017/myapp" - Docker 部署：用服务名替代
localhost——"mongodb://mongo:27017/myapp" - MongoDB Atlas：必须含查询参数
?retryWrites=true&w=majority，否则写入可能被拒绝 ——"mongodb+srv://user:pass@cluster.mongodb.net/myapp?retryWrites=true&w=majority" - 密码含特殊字符（如
@、/）必须用urllib.parse.quote_plus编码，再拼进 URI
插入后查不到？先确认这三件事
不是数据丢了，而是查询方式和类型没对上。MongoDB 不会自动帮你转换类型或忽略大小写。
- 查之前先确认集合存在：
mongo.db.list_collection_names()，避免拼成user而不是users -
find_one({"_id": "507f1f77bcf86cd799439011"})查不到？因为_id是ObjectId类型，得显式转换：from bson import ObjectId; find_one({"_id": ObjectId("507f1f77bcf86cd799439011")}) - 字段名别用 Python 关键字（如
class、type），虽然插入成功，但后续用点号访问（doc.class）会语法报错
多个 MongoDB 数据库怎么同时连
Flask-PyMongo 默认只支持一个 mongo 实例，要连多个库，得手动用原生 pymongo.MongoClient 管理连接，绕过 Flask-PyMongo 的封装。
- 定义两个独立客户端：
client_a = MongoClient("mongodb://host1:27017/")和client_b = MongoClient("mongodb://host2:27017/") - 分别取库：
db_a = client_a["db1"]，db_b = client_b["db2"]，再各自取集合 - 注意连接复用：不要每次请求都新建
MongoClient，它本身是线程安全、可复用的；全局单例即可 - 若需 Flask 上下文集成（如自动关闭），可在
app.teardown_appcontext里手动 close 对应 client
最容易被忽略的是 ObjectId 类型转换和 URI 中的 retryWrites 参数——前者导致“明明插了却查不到”，后者在云环境里让写操作直接静默丢弃。别信“应该能连上”，每个 URI 都该拿 mongo.client.server_info() 实测一次。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
