MongoDB插入文档报错“文档含错误时不允许插入”，求代码问题排查

你提供的待插入JSON数组语法完全合法，问题不出在JSON的括号匹配上，可从以下几个方向排查： #

1. 检查插入方法是否正确 #

• 批量插入多条文档必须使用对应驱动的批量插入接口：
  • 原生MongoDB驱动：使用db.collection(<集合名>).insertMany(<文档数组>)
  • Mongoose ODM：使用Model.insertMany(<文档数组>) 或 Model.create(<文档数组>)
• 禁止使用单条插入接口insertOne传入数组，会直接触发格式错误。

2. 检查ODM（如Mongoose）的Schema校验规则 #

这是该报错最常见的触发原因：

• 字段类型不匹配：你当前文档中category字段为字符串格式的ObjectId，如果Schema中定义该字段类型为mongoose.Types.ObjectId，插入前需要先将字符串转换为ObjectId类型，示例转换写法：

// 单个字段转换示例
const doc = {
  ...其他字段,
  category: mongoose.Types.ObjectId("5faa35a88fdff228384d51d8")
}

• 缺失必填字段：检查Schema中是否标记了其他required: true的字段，而你提供的文档中没有对应字段。
• 多余字段拦截：如果Schema设置了strict: true（默认开启），文档中存在Schema未定义的字段也会被拦截报错。

3. 检查可视化工具插入操作是否正确 #

如果你是在MongoDB Compass中手动插入数据：
不要直接将数组粘贴到单文档插入的输入框，点击插入按钮的下拉选项，选择「插入多个文档」后再粘贴数组即可。 #

验证建议 #

在插入代码中添加完整的错误捕获逻辑，打印完整报错信息，可直接定位到具体是哪个字段、哪条规则校验失败：

// Mongoose 示例
ProductModel.insertMany(yourDocArray)
  .then(res => console.log('插入成功：', res))
  .catch(err => console.error('详细错误信息：', err))

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