Mongoengine .save()无法保存文档，但PyMongo insert_one()可正常工作

核心问题复盘 #

你遇到的情况是：Mongoengine的save()方法无法将新创建的BlotterItem文档存入数据库，调用save(force_insert=True)时还会抛出NotUniqueError（提示_id重复），但数据库中根本不存在该_id的文档；而通过item.to_mongo()转换后用PyMongo的insert_one()却能成功插入。

可能原因与对应解决方案 #

1. MongoDB的_id索引存在脏数据 #

MongoDB的唯一索引可能残留了已删除文档的_id记录，导致Mongoengine判断重复，但实际文档已不存在。

• 验证步骤：用PyMongo查询该_id是否存在：

  from bson.objectid import ObjectId
  # 替换为你的collection对象
  print(collection.find_one({"_id": ObjectId("63401b7e82967e682f0714e0")}))
  

• 解决方法：如果返回None，重建_id索引：

  collection.drop_index("_id_")
  collection.create_index("_id", unique=True)
  

2. 文档对象被误分配了旧_id #

新创建的BlotterItem对象可能从某些上下文（比如复制旧对象、反序列化残留）继承了已存在的_id，导致Mongoengine认为是更新操作而非插入。

• 解决方法：手动重置_id后再保存：

  item = BlotterItem(<你的初始化参数>)
  item._id = None  # 强制生成新的ObjectId
  item.save()
  

3. 继承配置导致的逻辑冲突 #

你的模型开启了allow_inheritance=True，Mongoengine会自动添加_cls字段用于继承类区分，该字段的处理逻辑可能干扰了save()方法的判断。

• 验证步骤：临时修改meta关闭继承：

  meta = {
      'db_alias' : 'db1',
      'collection' : 'Blotter',
      'allow_inheritance': False
  }
  

  如果此时save()成功，说明是继承逻辑的问题，可进一步检查子类定义，或显式指定_cls字段值。

4. Mongoengine误判文档状态 #

Mongoengine的Document对象有_created属性，用于标记是否为新创建的文档，如果该属性被误设为False，会导致save()执行更新而非插入。

• 验证步骤：打印文档状态：

  print(item._created)  # 新文档应返回True
  

• 解决方法：如果返回False，强制插入并关闭验证尝试：

  item.save(force_insert=True, validate=False)
  

补充说明 #

既然item.to_mongo()能正常插入，说明你的模型字段定义完全没问题，问题集中在Mongoengine的上层逻辑处理，按上述步骤逐一排查即可解决。

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