MongoDB中_id同时为ObjectId和字符串时查询无结果的解决咨询

核心问题 #

你的查询无结果是因为**_id的数据类型不匹配**：

• 迁移生成的文档，_id是MongoDB原生的ObjectId对象类型
• 后续插入的文档，_id是普通字符串类型

Mongoose的findById()方法默认会把传入的字符串参数转换为ObjectId类型去匹配，所以当你查询_id为字符串类型的文档时，类型不匹配导致无法命中；反过来，用ObjectId去匹配字符串_id也会失败。

解决方法 #

1. 统一所有文档的_id类型（推荐） #

长期来看，统一_id类型能彻底避免这类问题，推荐二选一：

把字符串_id转为ObjectId

在MongoDB Shell中执行（替换yourCollection为你的集合名称）：

db.yourCollection.updateMany(
  { _id: { $type: "string" } },
  [ { $set: { _id: { $toObjectId: "$_id" } } } ]
)

注意：仅当字符串格式是合法的ObjectId时才能执行成功，否则会抛出错误。

把ObjectId转为字符串

如果更倾向用字符串作为_id，执行：

db.yourCollection.updateMany(
  { _id: { $type: "objectId" } },
  [ { $set: { _id: { $toString: "$_id" } } } ]
)

2. 临时兼容两种类型查询 #

如果暂时无法统一类型，可以修改查询语句，同时匹配两种类型：

// Mongoose 代码示例
Document.findOne({
  $or: [
    { _id: 'some id value' },
    { _id: mongoose.Types.ObjectId('some id value') }
  ]
})

这样不管目标文档的_id是字符串还是ObjectId，都能被匹配到。

3. 规范新文档的_id类型 #

为了防止后续再出现类型不一致，在Mongoose Schema中明确配置_id类型：

统一使用ObjectId（默认行为，显式声明更清晰）

const yourSchema = new mongoose.Schema({
  // 其他字段定义
}, { _id: true });

新插入的文档会自动生成ObjectId类型的_id。

统一使用字符串

const yourSchema = new mongoose.Schema({
  _id: { type: String, required: true },
  // 其他字段定义
}, { _id: false }); // 关闭自动生成ObjectId的逻辑

后续插入文档时需要手动指定字符串类型的_id。

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