如何在Mongoose中填充另一模型中子Schema的关联字段？

问题核心 #

Mongoose默认不支持直接将字段关联到父文档的子文档数组元素（即ref: "User.address"这种写法无效，因为子文档没有独立的模型），直接ref: "User"会返回null，因为addressId匹配的是子文档的_id，而非User文档的_id。

可行解决方案 #

方案1：使用聚合查询（$lookup + 筛选）

通过MongoDB的聚合管道，先找到包含目标子文档的父用户，再从用户的地址数组中筛选出匹配的地址：

// 假设你的模型定义如下
const addressSchema = new mongoose.Schema({
  street: String,
  city: String
});

const userSchema = new mongoose.Schema({
  name: String,
  addresses: [addressSchema]
});

const User = mongoose.model('User', userSchema);

const ledgerSchema = new mongoose.Schema({
  amount: Number,
  addressId: mongoose.Schema.Types.ObjectId
});

const Ledger = mongoose.model('Ledger', ledgerSchema);

// 聚合查询获取填充后的ledger数据
const getLedgerWithAddress = async (ledgerId) => {
  const result = await Ledger.aggregate([
    // 关联包含目标addressId的用户
    {
      $lookup: {
        from: 'users', // 注意是User模型对应的集合名（默认复数）
        localField: 'addressId',
        foreignField: 'addresses._id',
        as: 'relatedUser'
      }
    },
    // 展开用户数组（每个addressId对应唯一用户）
    { $unwind: '$relatedUser' },
    // 从用户地址数组中筛选出匹配的地址，并重构输出结构
    {
      $project: {
        amount: 1,
        address: {
          $arrayElemAt: [
            {
              $filter: {
                input: '$relatedUser.addresses',
                cond: { $eq: ['$$this._id', '$addressId'] }
              }
            },
            0
          ]
        }
      }
    }
  ]);
  return result[0];
};

方案2：重构数据结构，将子文档改为独立模型

如果业务允许，把Address拆成独立模型，通过引用关联到User和Ledger，这是最符合Mongoose设计规范的方案：

// 独立的Address模型
const Address = mongoose.model('Address', new mongoose.Schema({
  street: String,
  city: String,
  userId: { type: mongoose.Schema.Types.ObjectId, ref: 'User' }
}));

// User模型通过ObjectId引用Address
const userSchema = new mongoose.Schema({
  name: String,
  addresses: [{ type: mongoose.Schema.Types.ObjectId, ref: 'Address' }]
});
const User = mongoose.model('User', userSchema);

// Ledger模型直接关联Address模型
const ledgerSchema = new mongoose.Schema({
  amount: Number,
  addressId: { type: mongoose.Schema.Types.ObjectId, ref: 'Address' }
});
const Ledger = mongoose.model('Ledger', ledgerSchema);

// 填充时直接调用populate即可
const ledger = await Ledger.findById(ledgerId).populate('addressId');

方案3：自定义填充函数（Mongoose 4.5+）

利用Mongoose的自定义填充逻辑，手动从关联的User中提取匹配的地址：

// 在ledgerSchema定义后添加自定义填充规则
ledgerSchema.path('addressId').populate({
  model: 'User',
  match: (doc) => ({ 'addresses._id': doc.addressId }),
  transform: function(user) {
    // 从用户的地址数组中找到匹配的项
    return user?.addresses.find(addr => addr._id.toString() === this.addressId.toString());
  }
});

// 查询时执行填充
const ledger = await Ledger.findById(ledgerId).populate('addressId');

方案推荐 #

• 如果可以调整数据结构，优先选方案2，逻辑更清晰，后续维护更简单；
• 无法修改结构时，优先用方案1的聚合查询，稳定性和灵活性更强；
• 方案3适合简单场景，但要注意上下文绑定和性能问题（大量数据时不如聚合高效）。

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