如何通过PyMongo实现MongoDB文档_id字段的批量更新

pymongo完全可以实现该需求，你遇到的无法修改_id、无法插入新文档的核心原因是Python字典的操作逻辑和mongosh的JS对象操作逻辑不同：mongosh中查询返回的结果是JS对象，可以直接用doc._id = xxx的点语法修改属性，但pymongo的find_one返回的是Python原生字典，必须通过键名的方式修改_id字段，直接用点语法赋值只是给字典对象添加了一个临时属性，不会修改字典内存储的文档内容，自然无法完成_id替换。

前置依赖说明 #

首先确保导入正确的ObjectId类，注意不要单独安装第三方bson包，pymongo自带适配版本的bson模块，单独安装会出现类型兼容问题：

from pymongo import MongoClient
from bson import ObjectId
from pymongo import InsertOne, DeleteOne # 批量操作需要用到

单条文档替换实现 #

完全对齐你给出的mongosh逻辑，保留「先插新文档、成功后再删旧文档」的安全顺序，避免数据丢失：

# 初始化数据库连接，按实际环境修改连接地址、库名、集合名
client = MongoClient("mongodb://你的数据库连接地址")
db = client["你的业务库名"]
col = db["clients"]

old_id = ObjectId("4cc45467c55f4d2d2a000002")
new_id = ObjectId("4c8a331bda76c559ef000004")

# 1. 查询原文档
doc = col.find_one({"_id": old_id})
if not doc:
    raise ValueError(f"未找到_id为{old_id}的文档")

# 2. 修改_id，注意是字典键赋值，不是doc._id = new_id
doc["_id"] = new_id

# 3. 插入新_id的文档
try:
    col.insert_one(doc)
except Exception as e:
    print(f"新文档插入失败，终止操作，错误信息：{str(e)}")
    raise

# 4. 插入成功后删除旧_id文档
col.delete_one({"_id": old_id})

批量操作优化（适合大量记录更新场景） #

单条循环发送请求网络开销大，记录较多时推荐用bulk_write批量提交操作，执行效率会提升数倍：

# 配置需要替换的新旧id映射，格式为(旧id字符串, 新id字符串)
id_map_list = [
    ("4cc45467c55f4d2d2a000002", "4c8a331bda76c559ef000004"),
    # 追加更多需要替换的id对
]

bulk_operations = []
for old_id_str, new_id_str in id_map_list:
    old_id = ObjectId(old_id_str)
    new_id = ObjectId(new_id_str)
    doc = col.find_one({"_id": old_id})
    if not doc:
        print(f"跳过不存在的文档，旧id：{old_id_str}")
        continue
    doc["_id"] = new_id
    bulk_operations.append(InsertOne(doc))
    bulk_operations.append(DeleteOne({"_id": old_id}))

if bulk_operations:
    # ordered=True保证操作按顺序执行，插入失败不会执行后续删除，避免丢数据
    result = col.bulk_write(bulk_operations, ordered=True)
    print(f"批量操作完成：成功插入{result.inserted_count}条，成功删除{result.deleted_count}条")

注意事项 #

• 执行批量操作前务必备份目标集合，避免操作失误导致数据丢失
• 一定不要调换插入和删除的顺序，必须确认新文档插入成功后再删除旧文档
• 如果业务集合中有其他文档关联了被修改的_id，需要同步更新关联字段，避免数据不一致
• 如果开启了副本集，操作完成后可以检查secondary节点的数据同步状态，确认数据一致

内容的提问来源于stack exchange，提问作者thathashd