MongooseJS中.populate()无法返回父模型Product字段的问题

场景与模型定义 #

现有Product和Book两个模型，Book通过Mongoose鉴别器继承自Product，模型定义如下：

const ProductSchema = new mongoose.Schema(
  {
    name: {...},
    description: {...},
    images: [{... }],
    inventory: { ... },
    department: { ... }, 
    // 其他字段
  },
  {
    timestamps: true,
    toJSON: { virtuals: true },
    toObject: { virtuals: true },
    discriminatorKey: "kind",
  }
)
 
const Product = mongoose.model("Product", ProductSchema)  

const BookSchema = new mongoose.Schema({
    subtitle: { ...  },
    abstract: {  ... },
    publisher: {  ... },
    authors: { ...  },
    // 其他字段
},
    {
        timestamps: true, 
        discriminatorKey: "kind",
        toJSON: { virtuals: true },
        toObject: { virtuals: true }
    }
)

const Book = Product.discriminator("Book", BookSchema) 

另外有Cart模型，其products子文档包含引用Product的productID字段：

const cartItem = new mongoose.Schema({
    productID: {
        type: mongoose.Types.ObjectId,
        ref: "Product",
        required: [true, "Please provide productID. "]
    },
    quantity: { ... },
    sessionID: { ... },
}) 

const cartSchema = new mongoose.Schema({
    products: [cartItem],
    active: {
        type: Boolean,
        default: true,
        hide: true,
    },
    sessionID: {
        type: mongoose.Types.ObjectId,
        ref: "Session"
    }
}, {
    timestamps: true,
    toJSON: { virtuals: true },
    toObject: { virtuals: true },
})

const Cart = mongoose.model("Cart", cartSchema)

使用Mongoose版本为v6.8.3，执行以下代码对Cart实例进行populate操作后，仅返回Book模型的字段，未包含父模型Product的字段：

const newCart = new Cart({...}) 
await newCart.save()
let populatedCart = await newCart.populate({ path: "products.productID", model: Product})

解决方案 #

1. 确保鉴别器模型提前注册 #

Mongoose需要在执行populate前，确认所有鉴别器模型（如Book）已完成定义并注册到父模型Product下。如果Book模型的定义晚于Cart的populate操作，Mongoose无法识别鉴别器类型，会导致仅返回子模型字段。

2. 开启Populate的鉴别器支持 #

在Mongoose v6中，populate鉴别器模型时，需在配置中显式添加discriminators: true，让Mongoose自动合并父模型与子模型的字段：

let populatedCart = await newCart.populate({ 
  path: "products.productID", 
  model: Product,
  discriminators: true // 关键配置，启用鉴别器字段加载
})

3. 检查discriminatorKey一致性 #

确保父模型与子模型的discriminatorKey配置一致（此处均为kind），且子文档存入数据库时kind字段已正确设置为"Book"。若kind字段缺失，Mongoose会将其视为普通Product模型，可能引发字段加载异常。

4. 改用查询式Populate（可选） #

若实例级populate仍有问题，可通过Cart模型的查询方法执行populate，确保上下文正确：

let populatedCart = await Cart.findById(newCart._id).populate({
  path: "products.productID",
  model: Product,
  discriminators: true
})

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