根本原因是MongoDB服务未运行或PyMongo连接地址端口错误；本地用localhost:27017，Docker容器内连宿主需用host.docker.internal（Mac/Win）或宿主机IP（Linux），并加serverSelectionTimeoutMS参数、try/except捕获异常。
PyMongo连接MongoDB时为什么总报ConnectionRefusedError
根本原因通常是MongoDB服务没起来，或者PyMongo连错了地址和端口。本地开发默认是localhost:27017，但Docker里跑的MongoDB容器，宿主机Python代码得用host.docker.internal（Mac/Windows）或宿主机IP（Linux），不能写localhost——容器里localhost指向自己，不是宿主机。
- 检查MongoDB是否运行：
mongod --version或docker ps | grep mongo - 连接字符串优先用
mongodb://localhost:27017（本地）或mongodb://host.docker.internal:27017（Docker容器内连宿主） - 加
serverSelectionTimeoutMS=5000参数，避免连接卡死：MongoClient("mongodb://localhost:27017", serverSelectionTimeoutMS=5000) - 务必在
try/except里做连接测试，捕获ServerSelectionTimeoutError和ConnectionFailure
Flask应用里怎么安全地管理PyMongo连接
别在每次请求里新建MongoClient，它本身是线程安全、带连接池的，全局复用一个实例就行；但也不能直接当模块变量裸奔，得配合Flask的app.teardown_appcontext做轻量清理（其实主要是为测试隔离准备的）。
- 在
app.py或extensions.py里初始化一次：mongo = MongoClient("mongodb://localhost:27017") - 用
app.config["MONGO_URI"]统一配置，再传给MongoClient，方便环境切换 - 数据库对象（
db = mongo["myapp"]）可以挂到g上按需获取，但更推荐直接从mongo实例取：mongo.db_name.collection_name - 不手动调
close()——Flask生命周期结束时连接池自动回收，强行关可能影响复用
insert_one和insert_many写入失败却不报错？
PyMongo默认不校验字段合法性，比如往要求_id唯一的地方重复插，或写入含NaN、Infinity的值，会静默失败或抛WriteError。必须主动检查返回结果或开启严格模式。
-
insert_one返回的是InsertOneResult对象，看.acknowledged和.inserted_id是否有效 - 批量插入时，
insert_many(..., ordered=False)能让部分失败不影响其余；但默认ordered=True，一个错全滚 - 对关键字段加
validator：用db.create_collection("users", validator={"$jsonSchema": {...}})提前拦截非法结构 - 避免直接存
datetime.date，PyMongo只认datetime.datetime，否则会抛TypeError
Flask路由里查MongoDB，为什么响应越来越慢
没建索引是最常见原因。PyMongo不会自动优化查询，find({"status": "active"})这种语句在万级数据上没索引就是全表扫。
立即学习“Python免费学习笔记（深入）”；
- 用
explain()看执行计划：collection.find({"uid": 123}).explain("executionStats")，重点看nReturned和totalDocsExamined - 复合查询优先建复合索引，比如
find({"type": "order", "created_at": {"$gt": ...}})，建create_index([("type", 1), ("created_at", -1)]) - 注意
_id索引默认存在，但只对_id单字段有效；{"_id": {"$in": [...]}}走索引，{"_id": {"$gt": ...}}也走，但{"_id": "string"}（类型不匹配）不走 - 聚合管道里
$match尽量往前放，越早过滤数据，后续阶段压力越小
索引不是越多越好，写多读少的集合要谨慎；另外Flask调试模式下频繁重载可能让PyMongo重复建索引，上线前确认索引只在初始化时建一次。
