Mongoose.js如何匹配字段值填充外键虚拟字段并过滤数据

完全可以仅通过Mongoose原生population方法实现需求，无需借助聚合查询或其他查询方式。

你之前添加match过滤未生效，通常由以下问题导致：

• 虚拟字段定义时机错误：虚拟属性必须在Schema创建完成、模型编译（调用mongoose.model()）之前定义，模型生成后追加的虚拟字段配置不会生效
• 未开启虚拟字段序列化：默认虚拟字段不会出现在查询返回的文档结果中，未开启虚拟字段序列化配置时，自定义的match规则也无法正常执行
• match配置位置错误：match属于populate行为的配置项，必须写在virtual的配置对象、或populate方法的入参对象中，写在Schema根配置或字段配置中不会生效

以下两种方案均可实现需求，根据业务场景选择即可：

方案1：虚拟字段内置固定过滤规则 #

如果所有查询listing虚拟字段的场景都需要过滤软删除记录，直接在虚拟字段定义时写入match规则，一次配置全局生效：

const BookSchema = new mongoose.Schema({
  uuid: { type: String, required: true, unique: true },
  name: { type: String, required: true }
}, {
  timestamps: true,
  // 开启虚拟字段序列化，确保虚拟字段可正常返回
  toObject: { virtuals: true },
  toJSON: { virtuals: true }
});

// 虚拟字段必须在mongoose.model()调用前定义
BookSchema.virtual('listing', {
  ref: 'Listing',
  localField: '_id',
  foreignField: 'book',
  justOne: true,
  // 核心过滤规则：仅匹配未软删除的上架记录
  match: { isDeleted: false },
  // 匹配不到有效记录时返回undefined，序列化时自动剔除该字段，满足无有效记录不返回的要求
  transform: (doc) => doc ?? undefined
});

const BookModal = mongoose.model('Book', BookSchema);

配置完成后直接调用.populate('listing')即可得到预期结果。

方案2：populate调用时动态传入过滤规则 #

如果不同查询场景对listing的过滤规则有差异，无需在虚拟字段上写死match，在populate调用时动态传入配置即可：

const books = await BookModal.find().populate({
  path: 'listing',
  match: { isDeleted: false },
  justOne: true,
  transform: (doc) => doc ?? undefined
});

基于你提供的测试数据，配置完成后返回结果完全符合预期：

• _id为665zadas99的书籍：自动填充关联的isDeleted为false的有效Listing记录
• _id为776abebt00的书籍：无符合条件的有效Listing，返回结果中不会出现listing字段

内容的提问来源于stack exchange，提问作者Happy Coder