MongoDB通过ObjectId过滤文档失效：ObjectId未定义报错问题

1. 先解决ReferenceError: ObjectId is not defined报错 #

这个问题的核心是你没在代码里正确引入ObjectId类型，根据你使用的工具（MongoDB官方驱动/Mongoose），按以下方式引入：

• 使用MongoDB官方驱动：

  // CommonJS语法
  const { ObjectId } = require('mongodb');
  // ES模块语法
  import { ObjectId } from 'mongodb';
  

• 使用Mongoose：

  // CommonJS语法
  const { ObjectId } = require('mongoose');
  // 或者直接取Types下的ObjectId
  const ObjectId = require('mongoose').Types.ObjectId;
  // ES模块语法
  import { ObjectId } from 'mongoose';
  

2. 正确的过滤写法 #

写法一：显式用ObjectId构造函数（最稳妥） #

// 示例：更新users集合中指定_id的文档
db.collection('users').updateOne(
  { _id: ObjectId('6365050650c6be6d5d090135') }, // 正确的过滤条件
  { $set: { nickname: '更新后的昵称' } } // 要更新的字段
);

注意：这里传入ObjectId的参数是纯24位十六进制字符串，不要包裹ObjectId()。

写法二：直接传字符串（部分场景支持） #

如果你的MongoDB驱动/Mongoose版本较新，可以直接用字符串匹配，驱动会自动转换为ObjectId：

db.collection('users').updateOne(
  { _id: '6365050650c6be6d5d090135' },
  { $set: { nickname: '更新后的昵称' } }
);

这种写法兼容性稍弱，老版本工具可能不支持，优先推荐第一种写法。

3. 你之前的写法为什么无效 #

• {_id : ObjectId(123....7890)}：缺少字符串引号，ObjectId构造函数必须接收字符串参数，会直接报错。
• {_id : "ObjectId('123....7890')"}：把_id当成普通字符串匹配，但MongoDB中的_id是ObjectId类型，完全不匹配，所以无效果。

内容的提问来源于stack exchange，提问作者marko-36