Mongoose聚合$match用正则匹配统计文档数报类型错误解决方法

• 实现目标：统计匹配指定正则规则的标签对应的文档数量，测试使用3条包含fullName字段、tags数组字段的车辆文档作为样本数据，预期输出为各标签名称及其对应出现次数的统计结果。
• 项目依赖版本：mongoose@^6.4.0、@nestjs/mongoose@^9.1.0

• 方案1：聚合管道先通过$unwind操作符拆解tags数组，在$match阶段直接传入RegExp实例做匹配，后续经$group分组计数、$project格式化输出字段，运行时触发TS类型报错：

Type 'RegExp' is not assignable to type 'Expression'

• 方案2：在$match阶段使用$regex操作符搭配$options:'i'配置做不区分大小写的正则匹配，运行时触发TS类型报错：

Object literal may only specify known properties, and '$regex' does not exist in type 'ArrayElemAt | First | Last | Reduce | ObjectToArray | RegexFindAll ... 132 more'

两类报错均为TypeScript类型校验导致：Mongoose 6.x+版本对聚合管道的表达式做了严格的类型定义，直接在$match阶段传入原生RegExp实例、或者在TS识别为聚合表达式的层级编写$regex字段，都会触发类型校验失败，并非MongoDB语法本身不支持该写法。

方案1：添加类型断言（写法简洁，推荐快速实现使用） #

在$match阶段的匹配规则后添加as any类型断言，跳过TS对该段配置的类型检查，原生支持的正则写法可正常运行：

// 示例：统计所有不区分大小写匹配"suv"的标签出现次数
const result = await VehicleModel.aggregate([
  // 拆解tags数组
  { $unwind: "$tags" },
  // 正则匹配标签
  {
    $match: {
      tags: /suv/i
      // 等价写法：tags: { $regex: "suv", $options: "i" }
    } as any
  },
  // 按标签分组计数
  {
    $group: {
      _id: "$tags",
      docCount: { $sum: 1 }
    }
  },
  // 格式化输出字段
  {
    $project: {
      tagName: "$_id",
      docCount: 1,
      _id: 0
    }
  }
]);

方案2：使用聚合原生正则操作符（符合TS类型规范，无额外断言） #

使用MongoDB聚合管道原生提供的$regexFind操作符实现正则匹配，该写法完全符合Mongoose 6.x的TS类型定义，不需要添加类型断言：

const result = await VehicleModel.aggregate([
  { $unwind: "$tags" },
  {
    $match: {
      $expr: {
        // 匹配结果不为空则视为命中规则
        $ne: [
          {
            $regexFind: {
              input: "$tags",
              regex: "suv",
              options: "i" // 配置不区分大小写
            }
          },
          null
        ]
      }
    }
  },
  {
    $group: {
      _id: "$tags",
      docCount: { $sum: 1 }
    }
  },
  {
    $project: {
      tagName: "$_id",
      docCount: 1,
      _id: 0
    }
  }
]);

注意事项 #

• 两种方案执行逻辑和返回结果完全一致，可根据项目的TS编码规范选择。如果项目禁止使用any类型断言，优先选择第二种方案。
• 若正则规则为动态传入的用户输入，需要提前对正则特殊字符做转义处理，避免正则注入风险。

内容的提问来源于stack exchange，提问作者I.Bozcan