PyMongo更新MongoDB嵌套对象新增字段update不生效问题

• 查询逻辑存在偏差：使用find_one搭配{'_id': {'$in': ids}}时，只要ids列表中存在多个_id值，MongoDB只会返回排序后第一条匹配的文档，如果你要操作的目标文档不是这条，后续更新自然不会落到预期位置。
• 本地修改未生效：大部分MongoDB驱动（如PyMongo）返回的查询结果是BSON类型对象，并非原生可变字典，直接对返回对象的嵌套字段执行update()修改，可能因为对象只读/属性追踪机制导致内存中的修改没有实际落地，后续$set写入的还是原始未修改的raw内容。
• 全量替换风险：就算本地修改生效，直接整体替换raw字段的写法，会覆盖两次查询之间其他进程对该文档raw字段的并发修改，同时如果missing_data存在和raw原有字段重名的键，也会无提示覆盖旧值。

优先使用MongoDB原生嵌套更新语法，原子完成字段新增，不需要先查询文档到本地修改，从根源避免上述问题：

# 待新增的字段内容
missing_data = {
    "abstract": "专利摘要内容",
    "description": "专利说明书内容"
}

# 构造嵌套更新规则，使用点表示法指定raw下的字段
update_rule = {"$set": {f"raw.{key}": value for key, value in missing_data.items()}}

# 直接指定目标文档_id执行更新，不会修改raw下其他原有字段
update_result = client.update_one(
    filter={"_id": "patent_1023"}, # 直接传入确定的目标_id，不要用$in匹配单条文档
    update=update_rule
)

# 可通过返回值确认执行结果
print(f"匹配文档数：{update_result.matched_count}，修改文档数：{update_result.modified_count}")

如果业务逻辑必须先拉取文档做校验再更新，需要注意两个要点：

1. 查询时直接传入确定的_id值，不要用$in做单文档查询，避免匹配到错误文档
2. 将返回的BSON对象转为原生Python字典后再做修改，避免只读属性导致修改不生效，参考代码：

target_doc_id = "patent_1023"
doc = client.find_one({"_id": target_doc_id})
if not doc:
    raise RuntimeError("未查询到目标文档")

# 转为原生字典后再修改
raw_content = dict(doc.get("raw", {}))
raw_content.update(missing_data)

# 执行更新
client.update_one(
    {"_id": target_doc_id},
    {"$set": {"raw": raw_content}}
)

提示：无特殊需求时优先选择第一种原子更新方案，执行效率更高，不会产生并发覆盖问题，也不会出现本地修改不生效的异常。

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