如何在Mongoose中为同对象属性设置refPath并正确填充？

问题背景 #

需要实现用户收藏不同类型产品的功能，现有User Schema结构如下，核心疑问：

• 如何设置refPath指向同一子文档内的product_type字段
• 当前Schema结构是否需要调整
• 如何正确填充查询结果

现有User Schema #

const UserSchema = new mongoose.Schema({
// ... 其他字段
bookmarks: [
    {
        product_type: { // 作为refPath的来源
            type: String,
            enum: ['vehicle', 'nutrition', 'accessory', 'etc...'],
        },
        product_id: {
            type: mongoose.Types.ObjectId,
            refPath: '' // 需指向Vehicle、Nutrition等模型
        },
    },
  ]
});

临时方案的局限性 #

曾采用过以下结构，但扩展性极差：新增产品类型时必须修改User Schema，维护成本高

bookmarks: {
    vehicle: [ mongoose.Schema.Types.ObjectId ],
    accessory: [ mongoose.Schema.Types.ObjectId ],
    ...
}

正确实现方案 #

1. 设置refPath #

不需要调整现有数组结构，直接将product_id的refPath指向当前子文档的product_type字段即可。注意**product_type的枚举值必须与对应Mongoose模型的名称完全一致**（比如模型定义为mongoose.model('Vehicle', VehicleSchema)，则product_type的值应为'Vehicle'，需同步修改enum）：

const UserSchema = new mongoose.Schema({
// ... 其他字段
bookmarks: [
    {
        product_type: {
            type: String,
            enum: ['Vehicle', 'Nutrition', 'Accessory'], // 与模型名完全匹配
            required: true
        },
        product_id: {
            type: mongoose.Types.ObjectId,
            refPath: 'product_type' // 指向当前子文档的product_type字段
        },
    },
  ]
});

2. 填充查询结果 #

查询用户时，通过populate方法指定路径为bookmarks.product_id，Mongoose会自动根据每个子文档的product_type匹配对应模型并填充数据：

// 回调写法
User.findById(userId)
  .populate('bookmarks.product_id')
  .exec((err, user) => {
    if (err) throw err;
    console.log(user.bookmarks); // 每个元素的product_id已填充为对应产品文档
  });

// async/await写法
const user = await User.findById(userId).populate('bookmarks.product_id');

3. 结构优势 #

原数组嵌套结构相比临时键值对结构的优势：

• 扩展性强：新增产品类型仅需在product_type的enum中添加值，无需修改Schema
• 统一管理：所有收藏记录以数组形式存储，便于批量查询、排序、筛选
• 符合Mongoose动态引用设计规范，长期维护成本低

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