Mongoose父引用虚拟填充无结果问题排查求助

以下是针对你遇到的问题的逐一排查步骤：

1. 验证关联数据的正确性 #

直接检查MongoDB数据库中Review集合的tour字段：

• 使用MongoDB命令行或Compass执行查询：db.reviews.find({tour: ObjectId("目标Tour的_id字符串")})
• 确认是否存在符合条件的Review文档，且tour字段的类型是ObjectId（而非字符串），并且与目标Tour的_id完全匹配。如果没有匹配的文档，虚拟填充自然返回空。

2. 检查虚拟字段的定义是否完整 #

确保Tour Schema的虚拟字段配置包含ref属性（这是最容易遗漏的点）：

const tourSchema = new mongoose.Schema({
  // 你的Tour字段定义
});

// 正确的虚拟字段配置示例
tourSchema.virtual('reviews', {
  ref: 'Review', // 必须指定关联的模型名称，与Review模型导出时的名称一致
  localField: '_id',
  foreignField: 'tour',
  count: true // 启用后返回数量，而非文档列表
});

如果缺少ref，Mongoose无法识别要关联的模型，填充操作会失效。

3. 确认模型加载顺序 #

Mongoose要求子模型（Review）必须先于父模型（Tour）注册，否则Tour的虚拟字段无法找到对应的Review模型：

• 检查你的代码加载顺序：确保mongoose.model('Review', reviewSchema)在Tour模型定义之前执行。
• 若使用模块化的文件结构，可在app入口文件中先导入所有子模型，再导入父模型。

4. 核对populate调用与虚拟字段的预期行为 #

因为你开启了count: true，虚拟字段reviews返回的是关联Review的数量（数字），而非文档数组。如果你的代码期望获取Review列表，需要修改虚拟字段配置：

• 去掉count: true，配置改为：

  tourSchema.virtual('reviews', {
    ref: 'Review',
    localField: '_id',
    foreignField: 'tour'
  });
  

• 调用populate时无需额外参数，直接await Tour.findById(tourId).populate('reviews')即可获取关联的Review文档数组。

5. 验证Schema的virtuals配置 #

确保Tour和Review模型都正确开启了虚拟字段的序列化：

// 在Schema定义完成后设置
tourSchema.set('toJSON', { virtuals: true });
tourSchema.set('toObject', { virtuals: true });

reviewSchema.set('toJSON', { virtuals: true });
reviewSchema.set('toObject', { virtuals: true });

注意：该配置必须在创建模型（mongoose.model）之前设置才会生效。

6. 排查版本兼容性问题 #

你使用的Mongoose 7.3.4版本的虚拟填充功能是稳定的，但如果以上步骤都排查无误，可尝试升级到最新的7.x版本（如7.6.x），排除版本特定的bug。

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