MongoDB $lookup聚合返回全部roles文档 关联角色权限匹配失效

核心逻辑错误 #

你的聚合写法没有实现关联匹配的过滤逻辑，直接导致$lookup返回关联集合的全量文档，具体问题点如下：

• 自定义pipeline模式的$lookup不会自动完成字段匹配。

  规则说明：$lookup分为两种关联模式，一种是基础的localField/foreignField模式，MongoDB会自动完成字段等值匹配；另一种是你使用的自定义pipeline模式，该模式下MongoDB不会自动执行关联匹配，所有过滤逻辑需要在pipeline内手动实现，无过滤条件时会拉取目标集合的全量文档。

• let变量的取值写法完全错误。你在两个$lookup阶段写的let: {'roleIds': '_id'}、let: {'permissionIds': "_id"}都是取了固定的字符串"_id"，既没有加$前缀引用当前文档的对应字段，把roleIds、permissionIds的真实值传入下游pipeline，后续自然没办法做匹配过滤。
• 匹配逻辑缺失。哪怕let变量取对了值，你写的pipeline从执行入口就没有$match过滤阶段，没有做“目标集合文档的_id 是否在传入的id集合中”的判断，自然会返回所有文档。

修正后的完整可运行代码 #

下面的逻辑完全覆盖你的需求：无论用户文档是否存在roleIds字段，用户本身的基础信息都会正常返回，没有匹配到角色的用户对应的roles字段会为空数组，不会出现数据丢失。

db.getCollection('users').aggregate([
  {
    $match: {
      'username': 'foo@bar'
    }
  },
  // 外层关联：查询用户匹配的角色列表
  {
    $lookup: {
      from: 'roles',
      // 正确引用当前用户文档的roleIds数组，传入pipeline上下文
      let: { roleIds: "$roleIds" },
      as: 'roles',
      pipeline: [
        // 关键匹配逻辑：仅保留_id在用户roleIds数组中的角色文档
        {
          $match: {
            $expr: {
              $in: ["$_id", "$$roleIds"]
            }
          }
        },
        // 内层关联：查询角色匹配的权限列表
        {
          $lookup: {
            from: 'permissions',
            // 正确引用当前角色文档的permissionIds值，传入pipeline上下文
            let: { permissionIds: "$permissionIds" },
            as: 'permissions',
            pipeline: [
              // 关键匹配逻辑：仅保留_id和角色permissionIds相等的权限文档
              {
                $match: {
                  $expr: {
                    $eq: ["$_id", "$$permissionIds"]
                  }
                }
              },
              {
                $project: {
                  name: 1
                }
              }
            ]
          }
        },
        {
          $project: {
            name: 1,
            permissions: 1
          }
        }
      ]
    }
  }
])

适配注意事项 #

• 如果后续你把角色的permissionIds从单值ObjectId改成数组结构，只需要把内层$match的$eq替换成$in即可，和外层匹配逻辑保持一致。
• 上述逻辑不会因为用户缺失roleIds字段就过滤掉用户：当roleIds不存在时，$$roleIds的值为null，$in匹配自然没有结果，用户文档会正常返回，仅roles字段为空数组，完全符合预期。

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