Mongoose 文档中关于空值合并赋值运算符的注意事项

在 JavaScript 开发中，空值合并赋值运算符（??=）是一种便捷的语法，用于在变量为 null 或 undefined 时赋予默认值。然而，当这种语法与 Mongoose 文档一起使用时，开发者可能会遇到一些意料之外的行为。

问题现象

当尝试在 Mongoose 子文档上使用空值合并赋值运算符时，后续的属性赋值不会按预期生效。例如：

const doc = new Model();
(doc.subdoc ??= {}).b = 6;
console.log(doc.subdoc.b); // 输出 undefined

这与普通 JavaScript 对象的行为不同，在普通对象上同样的操作会按预期工作：

const obj = {};
(obj.nested ??= {}).a = 5;
console.log(obj.nested.a); // 输出 5

原因分析

这种现象的根本原因在于 Mongoose 对子文档的特殊处理机制。当执行 doc.subdoc ??= {} 时：

1. 如果 subdoc 为 null 或 undefined，运算符会返回右侧的空对象 {}
2. 然而，Mongoose 内部会创建一个新的子文档实例来替换这个空对象
3. 后续对返回的空对象的属性赋值（.b = 6）实际上是在操作这个临时对象，而不是 Mongoose 创建的子文档实例

解决方案

在 Mongoose 中处理子文档时，推荐使用以下替代方法：

1. 使用 set() 方法：

   doc.set('subdoc.b', 6);
   

   这种方法会自动创建必要的子文档结构。

2. 显式创建子文档：

   if (!doc.subdoc) {
     doc.subdoc = new SubdocModel({ b: 6 });
   }
   

3. 对于嵌套路径（非子文档）：

   (doc.nested ??= {}).a = 5;
   

   这种语法在嵌套路径上可以正常工作，因为 Mongoose 对嵌套路径的处理方式与子文档不同。

最佳实践

为了避免这类问题，建议开发者：

1. 明确区分 Mongoose 中的嵌套路径和子文档
2. 在处理子文档时避免使用赋值运算符链
3. 优先使用 Mongoose 提供的专用方法（如 set()）来修改文档结构
4. 在不确定的情况下，先检查文档结构再进行操作

理解 Mongoose 的内部工作机制对于有效使用这个 ODM 库至关重要。虽然 JavaScript 的新特性很吸引人，但在与特定库或框架集成时，了解其特殊行为才能避免潜在的陷阱。