Mongoose deep populate()返回空数组 多层Schema关联查询问题求解

问题根因 #

1. Schema定义与实际使用不一致：你在ItemGroupSchema中定义items字段的ref关联是ItemModel，但第二步populate时手动指定model为ItemGroupModel才能拿到嵌套的分组数据，上下文模型校验不匹配，深层填充时触发异常直接返回空数组。
2. _id字段的特殊逻辑冲突：Mongoose默认将_id识别为文档内置主键，即使你手动将其定义为关联字段，填充path: '_id'时，Mongoose内部逻辑会优先将其作为主键值处理，不会走普通关联字段的查询逻辑，导致匹配失败。

解决方案 #

最优方案（推荐，无后续兼容问题） #

修改ItemGroupSchema的关联字段名，避开_id的特殊处理逻辑，同时修正items字段的ref定义：

const ItemGroupSchema = new mongoose.Schema<IItemGroup>({
    // 将原关联用的_id改为普通字段名，比如itemInfo，避免和内置主键冲突
    itemInfo: { type: mongoose.Schema.Types.ObjectId, required: true, ref: ItemModel.modelName },
    // 修正items的ref为ItemGroupModel，符合你嵌套分组的实际使用场景
    items: [{ type: mongoose.Schema.Types.ObjectId, ref: ItemGroupModel.modelName }]
}, { _id: false });

修正后的查询语句：

ItemGroupModel.find({ _id: 'root' })
.populate({
  path: 'items',
  populate: {
    path: 'itemInfo',
    model: ItemModel.modelName
  }
})

即可得到你期望的返回结果。

兼容方案（不推荐，仅用于不想修改字段名的场景） #

如果暂时不能修改字段名，可通过关闭严格填充校验临时解决：

ItemGroupModel.find({ _id: 'root' })
.populate({
  path: 'items',
  model: ItemGroupModel.modelName,
  options: { strictPopulate: false },
  populate: {
    path: '_id',
    model: ItemModel.modelName
  }
})

该方案依赖Mongoose的宽松校验逻辑，版本升级可能失效，建议优先使用修改字段名的方案。

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