MongoDB查询文档时如何避免所有_id自动转换为字符串（Node.js环境）

问题描述 #

在Node.js环境下使用collection.find({})查询MongoDB文档时，所有格式为{"$oid": "64e6fb236049651f4cebdc1"}的ID字段会被自动转换为字符串"64e6fb236049651f4cebdc1"。需要让查询结果保留ID的对象形式，但由于数据结构各异且包含多个ID字段，单个字段通过MongoDB.ObjectID(string)转回对象的方法不适用。已查阅谷歌及MongoDB Node.js驱动的findOptions文档，未找到可行方案。

解决方案 #

要实现保留ObjectId对象形式，可通过调整MongoDB Node.js驱动的BSON解析配置来实现，具体有两种方式：

1. 全局客户端配置 #

初始化MongoDB客户端时，通过bsonOptions禁用BSON类型到JS原生类型的自动转换：

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

const client = new MongoClient('你的MongoDB连接字符串', {
  bsonOptions: {
    promoteValues: false, // 核心配置：禁止自动转换BSON类型为JS原生类型
    promoteBuffers: false,
    promoteLongs: false
  }
});

该配置会对所有查询生效，所有返回文档中的ObjectId都会保持为ObjectId对象，不会被转为字符串。注意此配置会影响所有BSON类型（如Long、Buffer）的解析，需结合业务场景评估。

2. 单个查询配置 #

若无需全局修改，可在单个find查询的选项中指定bsonOptions：

const docs = await collection.find({}, {
  bsonOptions: {
    promoteValues: false
  }
}).toArray();

此方式仅对当前查询生效，灵活性更高。

补充说明 #

• 驱动默认开启promoteValues: true，会自动将ObjectId转为字符串、Long转为Number等；关闭该配置即可保留原BSON对象结构。
• 配置后，可通过id instanceof ObjectId判断是否为ID对象，通过id.toString()获取字符串形式的ID值。

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