MongoDB驱动拒绝JSON文档中含$oid的_id，如何导入固定ObjectId？

为啥会报错？ #

你从Compass导出的JSON是MongoDB的扩展JSON格式，里面的{"_id": {"$oid": "xxx"}}是用来标记ObjectId的特殊写法。但MongoDB驱动的insertMany不认这种格式——它会把这个当成普通的嵌套对象，而MongoDB本身禁止字段名以$开头，所以直接导入就触发了错误。

Compass导入正常是因为它内部会自动把这种扩展JSON转换成真正的ObjectId类型，相当于帮你做了格式转换。

解决办法 #

1. 代码里手动转换格式（以Node.js驱动为例） #

读取JSON文件后，遍历每个文档，把_id里的$oid值转换成ObjectId实例：

const { MongoClient, ObjectId } = require('mongodb');
const fs = require('fs');

async function importDocs() {
  // 连接数据库
  const client = await MongoClient.connect('mongodb://localhost:27017');
  const db = client.db('你的数据库名');
  const collection = db.collection('你的集合名');

  // 读取并解析JSON文件
  const rawData = fs.readFileSync('导出的文件.json');
  let docs = JSON.parse(rawData);

  // 处理每个文档的_id
  docs = docs.map(doc => {
    if (doc._id?.$oid) {
      doc._id = new ObjectId(doc._id.$oid);
    }
    return doc;
  });

  // 插入文档
  await collection.insertMany(docs);
  await client.close();
}

importDocs().catch(err => console.error(err));

2. 用mongoimport命令行工具导入 #

不想写代码的话，用官方的mongoimport工具更省事，它天生支持解析扩展JSON：

mongoimport --uri "mongodb://localhost:27017/你的数据库名" --collection 你的集合名 --file 导出的文件.json --jsonArray

这个行为是预期的吗？ #

完全是预期的。

• Compass是官方GUI工具，专门针对导出/导入做了适配，自动处理扩展JSON和原生BSON类型的转换。
• 驱动的insertMany是给程序用的，它接收的是普通的JS对象（对应MongoDB的BSON文档），不会自动识别扩展JSON的特殊语法，所以直接传带$oid的对象就会违反字段命名规则，报错很正常。

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