Mongoose中为何用mongoose.Types.ObjectId转换ID而非直接传字符串ID

首先明确基础逻辑：只要你在Schema里给对应字段定义了ObjectId类型（比如带ref的关联字段），Mongoose默认会在执行操作前做自动类型转换，合法的24位十六进制ID字符串会被自动转成ObjectId实例，所以直接传字符串ID的写法在绝大多数常规场景下是可以正常运行的。

除了你已经知道的「非法ID格式会直接抛错」的校验作用外，手动调用mongoose.Types.ObjectId()转换还有几个实际作用：

• 提前拦截非法参数，减少无效数据库开销
  自动转换发生在Mongoose执行操作的内部前置流程里，如果你在业务逻辑层、甚至接口参数校验层就手动做转换，就能在请求抵达数据库之前直接拦下格式不合法的ID，直接返回参数错误，不用发起无意义的数据库连接和查询请求，错误处理链路更短，资源消耗更低。
• 规避自动转换失效的边界场景
  Mongoose的自动转换不是100%覆盖所有场景的，以下场景自动转换不会触发，必须手动传ObjectId实例才能拿到正确结果：
  • 聚合管道的$match阶段，Mongoose不会对管道内的查询条件做类型自动转换，传字符串ID会匹配不上库中存的ObjectId类型字段
  • 直接通过Model.collection调用原生MongoDB驱动的方法时，完全绕过Mongoose的Schema逻辑，没有自动转换能力
  • 部分老版本Mongoose（5.x之前的迭代版本）对$in/$nin这类数组操作符内的元素不会做递归转换，传字符串会导致查询返回空结果
  • 当你给字段配置了type: Schema.Types.Mixed混合类型时，Mongoose不会做任何自动类型推断和转换
• 避免类型不一致导致的逻辑错误
  统一把ID转成ObjectId实例再传递，可以避免业务代码里出现同一个ID一会儿是字符串、一会儿是ObjectId实例的类型混乱问题，不会出现做相等判断时"61d2c9b0f0e..." === ObjectId("61d2c9b0f0e...")返回false的低级bug，调试和日志排查的时候也不用反复做类型转换。

到底需不需要每次都手动转？ #

如果你的项目只做常规的Mongoose CRUD操作，所有关联字段都正确定义了Schema类型，也没用到聚合、原生驱动调用、复杂查询操作符，直接传格式合法的字符串ID完全可以正常工作，不会有功能问题。
但从工程健壮性的角度，更推荐在接口参数校验层就统一把入参里的ID转成ObjectId格式，既提前做了参数合法性校验，也能彻底避开各种自动转换失效的坑。

// 常规CRUD场景 直接传字符串可正常运行
const articles = await Article.find({user: userId})

// 聚合/原生查询/复杂操作符场景 必须手动转
const articles = await Article.aggregate([
  { $match: { user: mongoose.Types.ObjectId(userId) } }
])

内容的提问来源于stack exchange，提问作者Muhammad Waqas Ilyas