ConnectionRefusedError主因是MongoDB服务未运行或配置不匹配：①mongod进程未启动；②端口非默认27017或未正确映射；③连接地址误用localhost而非127.0.0.1；④Docker容器未启动或端口未暴露。
连接MongoDB时为什么总是报 ConnectionRefusedError？
多数情况下不是代码写错了，而是 MongoDB 服务根本没在本地运行。PyMongo 默认尝试连接 localhost:27017，如果 mongod 进程没启动，或者端口被改过，就会直接抛出这个错误。
- 先在终端运行
mongod --version确认服务已安装 - 用
ps aux | grep mongod（macOS/Linux）或任务管理器（Windows）查进程是否存活 - 若使用 Docker，确保容器已启动：
docker ps | grep mongo，且端口映射正确（如-p 27017:27017） - 连接字符串可显式指定地址：
MongoClient("mongodb://127.0.0.1:27017/")，避免 DNS 解析干扰
insert_one() 和 insert_many() 的区别与选型
两者都返回一个结果对象，但行为差异直接影响错误排查和性能：
-
insert_one()插入单个文档，返回含inserted_id的InsertOneResult对象；若插入重复_id，抛出DuplicateKeyError -
insert_many()接收文档列表，支持ordered=False参数：设为False时，某条失败不影响其余插入，返回的InsertManyResult中inserted_ids可能不连续 - 批量插入超 10 万条时，建议分批调用
insert_many()（每批 ≤ 1 万），避免 BSON 大小超限（16MB）或内存溢出
用 update_one() 修改数据却没生效？
最常见原因是匹配条件没命中任何文档，而 PyMongo 默认不报错——它只告诉你“匹配了 0 条”，但你可能没检查 matched_count。
python-script-generator
下载
快速生成专业的 Python 脚本和应用代码。一键创建完整项目结构，支持CLI、API、爬虫、Bot、Django等多种项目类型，包含完整的项目结构、配置文件、依赖管理、测试、README和文档。
- 务必检查返回值：
result = collection.update_one({"name": "Alice"}, {"$set": {"age": 30}})，然后打印result.matched_count -
$set只更新字段，$unset删除字段，$inc增减数值；误用{"age": 30}（无操作符）会**完全替换整个文档**，丢失其他字段 - 更新嵌套字段用点号路径：
{"$set": {"profile.city": "Beijing"}}，但需确保父级字段存在，否则静默失败
删除操作后数据还在，delete_one() 和 delete_many() 怎么用才安全？
PyMongo 的删除是“软性”的——它只管执行，不管业务逻辑是否允许删。误删往往源于过滤条件太宽或没加确认。
立即学习“Python免费学习笔记（深入）”；
- 永远先用
find()预览将被删除的文档：list(collection.find({"status": "inactive"})) -
delete_one()只删第一个匹配项，delete_many()删全部；空条件{}会清空整个集合，没有回收站 - 生产环境建议加
collation或hint显式指定索引，避免全表扫描拖慢集群 - 删除前可先
update_one(..., {"$set": {"deleted_at": datetime.now()}})做逻辑删除，比物理删除更可控
MongoClient 实例，会导致连接数爆炸；又或者把所有数据库操作包在一个 try/except Exception 里，掩盖了 WriteConcernError 或网络超时这类具体问题。 
