Mongoose 中 discriminated 模型字段选择问题的分析与解决

在 MongoDB 对象建模工具 Mongoose 的最新版本中，开发者报告了一个关于字段选择的特殊问题。这个问题主要出现在使用 discriminated 模型（区分模型）时，当模型中设置了 select: false 的字段后，会导致该字段之后定义的所有字段都无法被正常选择。

问题现象

当开发者使用 discriminated 模型并设置了某个字段为 select: false 时，执行查询操作后，该字段之后定义的所有字段都不会出现在返回结果中。这个现象有几个关键特征：

1. 仅在使用 discriminated 模型时出现，普通模型不受影响
2. 必须存在 select: false 的字段才会触发
3. 只影响 select: false 字段之后定义的字段
4. 可以通过显式指定选择字段来规避问题
5. 问题从 Mongoose 8.10.1 版本开始出现，之前的版本表现正常

问题复现

以下是一个典型的复现代码示例：

const CarSchema = new mongoose.Schema(
  {
    make: {
      type: String,
      enum: ['mercedes'],
    },
  },
  {
    discriminatorKey: 'make',
  }
);

const MercedesSchema = new mongoose.Schema({
  vin: {
    type: String,
    select: false,
  },
  sunroof: Boolean,
});

const CarModel = mongoose.model('Car', CarSchema);
CarModel.discriminator('Car:mercedes', MercedesSchema, 'mercedes');

const newCar = await CarModel.create({
  make: 'mercedes',
  vin: 'someFakeVin',
  sunroof: true,
});

const car = await CarModel.findById(newCar._id);
const leanCar = await CarModel.findById(newCar._id).lean();

console.log('car', car);
console.log('leanCar', leanCar);

在这个例子中，vin 字段被设置为 select: false，之后定义的 sunroof 字段在普通查询中不会出现，但在使用 .lean() 方法时会正常显示。

技术分析

这个问题涉及到 Mongoose 的几个核心机制：

1. Discriminated 模型：Mongoose 提供的一种继承机制，允许在同一个集合中存储不同类型的文档，通过一个区分字段来识别具体类型。

2. 字段选择机制：Mongoose 允许通过 select: false 设置默认不返回某些字段，这是出于安全考虑，比如密码字段通常不希望默认返回。

3. 查询处理流程：Mongoose 在执行查询时，会构建一个选择器对象，决定从数据库返回哪些字段。在 discriminated 模型中，这个选择器的构建过程出现了问题。

问题的根源在于 Mongoose 8.10.1 版本对 discriminated 模型的选择器处理逻辑进行了修改，导致在遇到 select: false 字段后，后续字段的选择状态被错误地继承或覆盖。

解决方案

目前开发者可以采取以下几种临时解决方案：

1. 显式指定选择字段：在查询时明确指定需要返回的字段

   await CarModel.findById(id).select('sunroof');
   

2. 使用 .lean() 方法：转换为普通 JavaScript 对象可以绕过这个问题

   await CarModel.findById(id).lean();
   

3. 降级到 8.10.0 或更早版本：如果项目允许，可以暂时使用不受影响的版本

4. 调整字段顺序：将 select: false 的字段放在模型定义的末尾

最佳实践建议

为了避免类似问题，开发者在使用 discriminated 模型时应注意：

1. 谨慎使用 select: false，特别是在 discriminated 模型中
2. 重要的业务字段尽量定义在 select: false 字段之前
3. 在查询关键业务数据时，显式指定需要的字段
4. 升级 Mongoose 版本前，充分测试 discriminated 模型的行为

Mongoose 团队已经确认这是一个 bug，预计会在未来的版本中修复。开发者可以关注官方更新日志，及时获取修复信息。