Express JS如何实现不限量查询参数配合MongoDB聚合多$match分面搜索

Express 接收同名重复查询参数时，会自动将req.query对应的字段解析为数组，不需要额外使用Rest参数处理，你可以直接基于这个特性实现多维度分面过滤：

优化后的完整代码 #

app.get("/search", async (request, response) => {
  try {
    const textsearch = request.query.text;
    if (!textsearch) {
      return response.status(400).send({ message: "text参数为必填项" });
    }

    // 统一将key、value转为数组，兼容单组/多组过滤参数的场景
    let keys = request.query.key ? (Array.isArray(request.query.key) ? request.query.key : [request.query.key]) : [];
    let values = request.query.value ? (Array.isArray(request.query.value) ? request.query.value : [request.query.value]) : [];

    // 校验参数数量是否匹配，避免异常报错
    if (keys.length !== values.length) {
      return response.status(400).send({ message: "key与value参数数量不匹配" });
    }

    // 组装聚合管道基础结构
    const Pipeline = [
      {
        '$search': {
          'text': {
            'query': textsearch,
            'path': 'title',
          }
        }
      },
      {
        '$limit': 5
      }
    ];

    // 存在过滤参数时生成$match阶段，插入到$search和$limit之间
    if (keys.length > 0) {
      const matchCondition = {};
      keys.forEach((key, index) => {
        matchCondition[key] = values[index];
      });
      Pipeline.splice(1, 0, { '$match': matchCondition });
    }

    // 执行查询返回结果
    const result = await collection.aggregate(Pipeline).toArray();
    response.send(result);
  } catch (error) {
    response.status(500).send({ message: error.message });
  }
})

功能扩展说明 #

如果需要支持同一个字段匹配多个值（比如key=brand&value=rasna&key=brand&value=nestle匹配两个品牌），可以把matchCondition的组装逻辑修改为：

keys.forEach((key, index) => {
  if (matchCondition[key]) {
    // 已有同字段条件时转为$in匹配
    const existingVal = matchCondition[key];
    matchCondition[key] = { 
      $in: Array.isArray(existingVal.$in) ? [...existingVal.$in, values[index]] : [existingVal, values[index]] 
    };
  } else {
    matchCondition[key] = values[index];
  }
});

注意事项 #

• 建议新增字段白名单校验，只允许业务允许的字段作为过滤key，避免恶意用户查询敏感字段
• 如果你的MongoDB字段有数字、布尔等非字符串类型，需要根据字段类型对value做对应转换，否则会出现类型不匹配无法命中数据的问题

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