Mongoose聚合管道中子文档正则匹配失效问题求助

定义的Schema #

Role Schema #

const roleSchema = new Schema({
  roleName: {
    type: String,
    unique: true,
    required: [true, "Role Name is required"],
  },
  permissions: {
    type: [
      {
        type: mongoose.Schema.Types.ObjectId,
        ref: "Permission",
      },
    ],
    required: [true, "Permissions are required"],
  },
});

Permission Schema #

const permissionSchema = new Schema({
  permissionGroupName: {
    type: String,
    required: [true, "Permission Group Name is required"],
    enum: {
      values: ["User Management", "Role Management"],
      // prettier-ignore
      message: "Permission Group Name should be either User Management or Role Management",
    },
  },
  permissionName: {
    type: String,
    required: [true, "Permission Name is required"],
    unique: true,
  },
});

const Permission = mongoose.model("Permission", permissionSchema);

module.exports = Permission;

问题场景 #

Role的permissions字段存储Permission实例的ObjectId数组，使用聚合管道的$lookup关联权限后，在$match阶段的$or条件中尝试对关联后的populatedPermissions.permissionName做正则匹配，但该条件被忽略，返回结果不符合预期：

聚合管道代码 #

[
  {
    '$lookup': {
      foreignField: '_id',
      from: 'permissions',
      localField: 'permissions',
      as: 'populatedPermissions'
    }
  },
  {
    '$match': {
      '$or': [
        { roleName: { '$regex': '.*de.*' } },
        { populatedPermissions: { '$regex': '.*de.*' } },
        {
          'populatedPermissions.permissionName': { '$regex': '.*de.*' }   // 该正则匹配失效
        }
      ]
    }
  },
  { '$sort': { roleName: 1 } },
  { '$skip': 0 },
  { '$limit': 10 }
]

失效原因 #

populatedPermissions是数组类型字段，直接对populatedPermissions.permissionName使用$regex匹配时，MongoDB无法正确遍历数组中的每个元素执行匹配判断。这种写法仅适用于非数组的嵌套字段，针对数组字段必须使用专门的数组操作符处理。

正确解决方案 #

方案1：使用$elemMatch #

通过$elemMatch指定数组元素的匹配规则，让MongoDB遍历数组并检查是否存在符合条件的元素：

{
  '$match': {
    '$or': [
      { roleName: { '$regex': '.*de.*' } },
      { populatedPermissions: { '$regex': '.*de.*' } },
      {
        'populatedPermissions': {
          '$elemMatch': {
            'permissionName': { '$regex': '.*de.*' }
          }
        }
      }
    ]
  }
}

方案2：使用$expr结合$filter（更灵活） #

如果需要更复杂的逻辑判断，可以用$expr配合$filter筛选数组元素，再通过$size判断是否存在符合条件的元素：

{
  '$match': {
    '$or': [
      { roleName: { '$regex': '.*de.*' } },
      { populatedPermissions: { '$regex': '.*de.*' } },
      {
        '$expr': {
          '$gt': [
            {
              '$size': {
                '$filter': {
                  input: '$populatedPermissions',
                  cond: { '$regexMatch': { input: '$$this.permissionName', regex: '.*de.*' } }
                }
              }
            },
            0
          ]
        }
      }
    ]
  }
}

额外优化建议 #

将针对原始集合字段（如roleName）的$match条件移到$lookup之前执行，先过滤掉无关数据，减少后续$lookup的处理量，提升查询性能：

[
  {
    '$match': {
      '$or': [
        { roleName: { '$regex': '.*de.*' } }
      ]
    }
  },
  {
    '$lookup': {
      foreignField: '_id',
      from: 'permissions',
      localField: 'permissions',
      as: 'populatedPermissions'
    }
  },
  {
    '$match': {
      '$or': [
        { roleName: { '$regex': '.*de.*' } },
        { populatedPermissions: { '$regex': '.*de.*' } },
        {
          'populatedPermissions': {
            '$elemMatch': {
              'permissionName': { '$regex': '.*de.*' }
            }
          }
        }
      ]
    }
  },
  { '$sort': { roleName: 1 } },
  { '$skip': 0 },
  { '$limit': 10 }
]

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