Mongoose populate无法填充嵌套Site引用数组仅返回ObjectId

• 第一种populate实现的核心错误：给非引用路径sites错误绑定了model: 'Site'。sites是User Schema下的嵌套子文档数组，本身不直接指向Site模型，强行绑定模型会让Mongoose跳过对子文档内部site引用字段的正常填充流程，最终只返回子文档自带的_id与siteRole字段。
• 第二种实现的填充失效问题，本质是受第一种错误写法的调试干扰。实际上populate('sites.site')的链式写法本身可以正常工作，只是你之前的回调函数存在变量命名混乱的问题：exec回调拿到的是User实例，不是Site实例，命名为site很容易引入逻辑错误。

写法1：直接嵌套路径populate（适合单层引用场景） #

const user = await User.findById(id)
  .populate({
    path: 'sites.site',
    model: 'Site'
  })
  .exec()

写法2：嵌套populate配置（适合后续还要在Site实体上做二次关联填充的场景） #

const user = await User.findById(id)
  .populate({
    path: 'sites', // 此处绝对不能额外加 model: 'Site'
    populate: {
      path: 'site',
      model: 'Site'
    }
  })
  .exec()

修正后的回调写法（兼容老的Promise回调风格） #

User.findById(id)
  .populate('sites.site')
  .exec(function (err, userDoc) {
    if (err) return next(err)
    if (!userDoc) return res.sendStatus(401)
    return res.json(userDoc)
  })

sites数组的每个条目会完整包含关联的Site实体：

[
  {
    "_id": "60476bf103016cef60b63319",
    "siteRole": 11,
    "site": {
      "_id": "60xxxxxx",
      "name": "示例站点",
      "url": "https://example.com"
    }
  }
]

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