Mongoose通过ref填充数组失败问题求助

我正在开发一个个人信息管理系统，定义了以下Customer和Email数据模型：

const customerSchema = new mongoose.Schema({
  user: { type: mongoose.Schema.Types.ObjectId, ref: "user" },
  emails: [
    {
      type: mongoose.Schema.Types.ObjectId,
      ref: "email",
    },
  ],
  name: { type: String },
  surname: { type: String },
  avatar: { type: String },
  firm_role: { type: String },
  vat_number: { type: String },
  fiscal_code: { type: String },
  address: { type: String },
  birth_date: { type: Date },
  notes: { type: String },
});
const emailContactSchema = new mongoose.Schema({
  customer: { type: mongoose.Schema.Types.ObjectId, ref: "customer" },
  label: { type: String },
  email: { type: String },
  creation_date: { type: Date, default: new Date() },
});
module.exports = {
  Customer: mongoose.model("customer", customerSchema),
  Email: mongoose.model("email", emailContactSchema)
};

使用以下查询获取客户及其关联邮箱时，能拿到客户数据，但emails数组始终为空：

const customers = await Customer.find({ user: req.user.user_id })
    .skip(10 * parseInt(req.params.page))
    .limit(1)
    .populate("emails")
    .exec();

解决方案 #

1. 确认目标客户的emails数组本身存在数据 #

先跳过populate，直接查询客户数据，检查emails字段是否包含有效的ObjectId数组：

const targetCustomer = await Customer.findOne({ user: req.user.user_id });
console.log(targetCustomer.emails);

如果输出是空数组，说明问题出在客户数据本身——你需要先确保创建/更新客户时，已经把对应的Email的_id添加到emails数组中。

2. 验证Email文档的customer字段是否正确关联 #

查询对应客户的邮箱记录，确认存在关联关系：

const relatedEmails = await Email.find({ customer: targetCustomer._id });
console.log(relatedEmails);

如果没有返回任何邮箱数据，说明创建Email时没有正确设置customer字段为目标客户的_id，需要检查邮箱创建逻辑，确保存储的是有效的Customer ObjectId，而非字符串或其他无效值。

3. 明确指定populate的模型（可选但更稳妥） #

虽然你的ref配置看起来没问题，但可以在populate时明确指定模型名称，避免Mongoose自动匹配时出现意外：

const customers = await Customer.find({ user: req.user.user_id })
    .skip(10 * parseInt(req.params.page))
    .limit(1)
    .populate({ path: "emails", model: "email" }) // 明确指定模型
    .exec();

4. 检查数据类型是否匹配 #

确保Customer的emails数组中存储的是ObjectId类型，而非字符串。如果存的时候把_id转成了字符串，Mongoose无法匹配关联记录，会导致populate返回空。可以直接查看数据库中的customer集合，确认emails数组元素的类型是ObjectId。

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