连不上MongoDB主因是配置或初始化顺序错误：PyMongo需在Flask应用上下文就绪后初始化，URI须含mongodb://前缀及正确参数，插入后查询需注意ObjectId类型转换和集合存在性。
Flask 里用 PyMongo 连不上 MongoDB 怎么办
连不上基本是配置或初始化顺序错了。PyMongo 本身不自动集成 Flask 生命周期，PyMongo 实例必须在应用上下文就绪后才能安全调用 find、insert_one 等方法。
常见错误现象：RuntimeError: Working outside of application context 或 AttributeError: 'PyMongo' object has no attribute 'db'。
- 别在
app = Flask(__name__)前就初始化PyMongo(app)—— 此时app还没完成配置加载 - 别把
mongo.db.collection.find()写在模块顶层（即函数外），那会触发早于应用启动的执行 - 如果用了工厂模式（
create_app()），确保PyMongo是在app创建并配置完之后才实例化
Flask-PyMongo 的 MONGO_URI 格式怎么写才不报错
URI 错一个字符就会静默失败或抛出 ConnectionFailure，尤其容易漏掉 mongodb:// 前缀或端口后的斜杠。
使用场景：本地开发、Docker 部署、云数据库（如 MongoDB Atlas）。
- 本地默认：
MONGO_URI = "mongodb://localhost:27017/myapp"—— 注意末尾是数据库名，不是路径 - Docker 容器间连接：用服务名替代
localhost，例如"mongodb://mongo:27017/myapp" - Atlas 连接字符串类似：
"mongodb+srv://user:pass@cluster.mongodb.net/myapp?retryWrites=true&w=majority"，必须带?retryWrites=true&w=majority参数，否则可能写入失败 - 避免硬编码密码：从环境变量读取，比如
os.environ.get("MONGO_PASSWORD")，拼接进 URI 前做 URL 编码（用urllib.parse.quote_plus）
mongo.db.users.insert_one() 插入后查不到？
不是没插入，而是默认不自动创建集合或索引，且查询时容易忽略大小写、字段名拼写、ObjectId 类型转换。
性能影响：首次插入会创建集合，但无索引会导致后续查询变慢；写入后立即查，若没加 acknowledged=True（默认已开启），可能因网络延迟误判失败。
- 确认插入返回值：
result = mongo.db.users.insert_one({...})，检查result.acknowledged和result.inserted_id - 查之前先确认集合是否存在：
mongo.db.list_collection_names()，避免拼错成user或Users - 查
ObjectId字段要转类型：mongo.db.users.find_one({"_id": ObjectId("...")})，直接传字符串会查不到 - 插入文档里键名别用 Python 关键字（如
class、type），MongoDB 允许，但后续用点号访问会报错（doc.class）
并发请求下 PyMongo 连接池够不够用
够用，但得关掉自动连接池复用陷阱。PyMongo 默认启用连接池，但 Flask 多进程部署（如 gunicorn + worker > 1）时，每个 worker 进程会各自维护一套连接池，总连接数 = worker 数 × 每池最大连接数。
兼容性影响：MongoDB 服务端有最大连接数限制（如免费版 Atlas 仅 500），超限会拒绝新连接，表现为随机 ServerSelectionTimeoutError。
- 显式配置连接池：
MONGO_MAX_POOL_SIZE = 10、MONGO_MIN_POOL_SIZE = 2，避免默认 100 占满服务端资源 - 禁用 socket 超时重试（可选）：
MONGO_CONNECT_TIMEOUT_MS = 5000，防止慢节点拖垮整个请求链 - 别在请求中反复调用
PyMongo(app)初始化 —— 每次都新建连接池，内存和 FD 泄漏很快
最容易被忽略的是：开发时用 Flask 自带 server（单进程）没问题，一上生产换 gunicorn 就开始丢连接，问题不在代码逻辑，而在连接池配置没随部署模型调整。
