Mongoose中使用$addToSet操作ObjectId数组是否需要手动转换类型

结论 #

两种写法均可以正常运行，第一种直接传入id字符串的写法更符合Mongoose的设计规范，更推荐使用

原因解释 #

• 你已在Schema中明确声明roleIds数组的元素类型为mongoose.Schema.Types.ObjectId，Mongoose内置的类型自动转换机制会在执行更新操作前，自动将符合格式的ObjectId字符串转换为对应的ObjectId类型，不需要开发者手动处理。
• 第二种手动调用mongoose.Types.ObjectId()转换的写法效果和第一种完全等价，只是多了冗余的手动转换步骤，没有额外收益。

注意：如果传入的roleId不符合ObjectId的格式要求（非24位十六进制字符串），两种写法都会触发Mongoose的类型校验错误，无法执行更新操作。

特殊场景说明 #

只有当你使用原生MongoDB驱动（无Mongoose Schema层）进行更新操作时，才需要手动将字符串id转换为ObjectId类型，否则MongoDB会将其作为普通字符串存储，导致类型不匹配无法命中$addToSet的去重逻辑。

验证方式 #

你可以通过开启Mongoose debug模式查看实际发送到MongoDB的执行语句，验证自动转换效果：

mongoose.set('debug', true)

开启后执行第一种写法的更新，日志中可以看到roleId已经被自动转换为ObjectId类型。

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