如何在Mongoose查询中实现集合及关联子集合的populate填充

实现方案 #

你的场景属于反向关联填充：引用关系存在子集合（chapters）的文档上，父集合（books）没有存储子文档id，不能直接用常规populate，以下是两种生产环境常用的实现方式：

方案1：配置Mongoose虚拟字段（推荐，长期维护最优）

只需要在Book模型上新增虚拟字段配置，不需要修改现有数据结构，后续查询可以直接用populate语法关联章节，和常规正向关联用法完全一致。

1. 修改Book模型定义：

const mongoose = require('mongoose');

const bookSchema = new mongoose.Schema({
  // 保留原有Book模型的所有字段配置，例如书名、作者、出版时间等
  title: String,
  author: String,
  publishTime: Date
}, {
  // 必须加这两个配置，否则虚拟字段不会在查询结果中返回
  toJSON: { virtuals: true },
  toObject: { virtuals: true }
});

// 定义反向关联的虚拟字段
bookSchema.virtual('chapters', {
  ref: 'Chapter', // 关联的章节模型名称，和你定义Chapter模型时传入的名称一致
  localField: '_id', // Book模型用于关联的字段，默认用主键_id
  foreignField: 'book' // Chapter模型中存储Book引用的字段名，如果你存的字段叫bookId就替换成对应名称
});

module.exports = mongoose.model('Book', bookSchema);

2. 查询时直接populate即可：

// 查询单本书+对应所有章节
const singleBook = await Book.findById('目标bookId').populate('chapters');

// 查询所有书籍+每本书对应的章节列表
const allBooks = await Book.find().populate({
  path: 'chapters',
  // 可选：如果要对章节做筛选、排序、分页可以在这里加配置
  // match: { isDeleted: false },
  // select: 'title wordCount',
  // options: { sort: { order: 1 } }
});

方案2：不修改模型配置，临时查询实现

如果只是单次查询需要关联数据，不想改动模型定义，可以选以下两种写法：

• 聚合$lookup单次查询（性能更好）

const bookList = await Book.aggregate([
  // 这里可以加$match条件提前筛选需要的书籍，减少关联数据量
  // { $match: { author: '目标作者' } },
  {
    $lookup: {
      from: 'chapters', // 注意这里填MongoDB中chapters集合的实际名称，Mongoose默认是模型名转小写复数
      localField: '_id',
      foreignField: 'book', // Chapter模型中存Book引用的字段名
      as: 'chapters'
    }
  }
]);

• 两次查询手动组装（逻辑简单易读，适合数据量小的场景）

// 1. 查询所有目标书籍
const books = await Book.find();
// 2. 提取所有书籍id
const bookIds = books.map(book => book._id);
// 3. 批量查询关联的所有章节
const chapters = await Chapter.find({ book: { $in: bookIds } });
// 4. 手动把章节挂载到对应书籍上
const bookList = books.map(book => ({
  ...book.toObject(),
  chapters: chapters.filter(chap => chap.book.toString() === book._id.toString())
}));

注意事项 #

• 不管用哪种方案，都要确认Chapter模型中关联Book的字段名，和配置里的foreignField保持一致
• 用$lookup的时候注意from参数填的是MongoDB实际的集合名，不是Mongoose模型名，比如你定义Chapter模型时手动指定了集合名，要以实际名称为准
• 如果章节数据量很大，建议在populate或者$lookup的时候加筛选、分页条件，避免一次拉取过多数据影响性能

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