MongoEngine与Pymongo保存任意文档至集合时出现报错

我来帮你拆解这个棘手的问题——你遇到的mongoengine.errors.OperationError: Could not save document (assertion src/mongo/db/storage/mmap_v1/btree/key.cpp:626)错误，本质是MongoDB的MMAPv1存储引擎在处理索引键时触发了底层断言。哪怕你清空了集合、删除了显式索引，依然出现这个问题，大概率和MMAPv1的固有限制或者引擎层面的数据结构残留有关，下面是针对性的排查和解决步骤：

1. 先确认存储引擎和版本限制 #

MMAPv1是MongoDB较旧的存储引擎，现在已经被废弃（MongoDB 4.2+默认用WiredTiger），它对索引键的大小有严格限制：单个索引条目（包括键值和元数据）不能超过1024字节。哪怕你没手动建索引，MongoDB自动创建的索引（比如_id）或者曾经存在过的索引残留结构，都可能触发这个限制。

先检查当前使用的存储引擎：

db.serverStatus().storageEngine

如果返回的是{ "name" : "mmapv1" }，那你确实在使用这个受限的引擎。

2. 排查文档中的大字段或异常数据 #

哪怕没有显式索引，以下情况也可能触发底层BTREE错误：

• 自定义_id字段过长：如果你没有用默认的ObjectId作为_id，而是用了超长字符串/其他类型，可能超过MMAPv1的键大小限制
• 超大字段内容：某个字段（比如字符串、数组）的内容过大，哪怕没建索引，曾经的索引残留或者引擎内部的临时结构可能会处理这些数据
• 数据类型不匹配：MongoEngine定义的字段类型和实际要保存的数据不匹配（比如定义了StringField但存了超大二进制数据），导致引擎解析键时出错

3. 修复集合的BTREE结构 #

MMAPv1的BTREE结构可能出现损坏，修复操作可以重建数据和索引结构：

// 修复整个数据库（生产环境需谨慎，会锁库）
db.runCommand({ repairDatabase: 1 })

// 或者只修复目标集合
db.yourCollection.repair()

4. 强制重建集合（彻底清除残留结构） #

如果修复没用，建议导出数据后彻底重建集合：

1. 导出集合数据：

mongoexport --db your_database_name --collection your_collection_name --out collection_data.json

2. 删除原集合：

db.your_collection_name.drop()

3. 重新创建集合：

db.createCollection("your_collection_name")

4. 导入数据：

mongoimport --db your_database_name --collection your_collection_name --file collection_data.json

5. 考虑迁移到WiredTiger引擎 #

既然MMAPv1已经被废弃，长远来看建议迁移到WiredTiger引擎，它不仅没有这么严格的键大小限制，还支持更好的性能和压缩。迁移可以通过备份恢复、副本集滚动升级等方式完成。

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