MongoDB聚合中用$match处理可选过滤参数的实现方法

嘿，作为MongoDB新手碰到这种动态过滤的需求太正常了，我来帮你一步步搞定！

你的核心需求是只在过滤值存在时才应用对应的$match条件，空值就自动忽略。那我们可以通过动态构建$match查询对象来实现，而不是写死多个$match阶段。具体步骤如下：

1. 初始化基础匹配条件 #

先把固定生效的条件（比如is_active: 1）放进一个基础对象里，这部分不管有没有过滤参数都要生效：

let matchConditions = { is_active: { $eq: 1 } };

2. 动态添加过滤规则 #

针对每个从前端拿到的过滤字段，判断它是否有有效值（非undefined、非null、非空字符串），如果有就把对应的匹配规则加到matchConditions里：

if (req.body.filterSet !== undefined) { 
  const filterData = req.body.filterSet[0]; 
  // 处理violation_id（对应你原来硬编码的id匹配）
  if (filterData.violation_id !== undefined && filterData.violation_id !== null && filterData.violation_id !== '') {
    matchConditions.id = { $eq: filterData.violation_id };
  }
  // 处理notice日期范围（替换成你集合实际的日期字段名）
  if (filterData.start_notice || filterData.end_notice) {
    matchConditions.notice_date = {};
    if (filterData.start_notice) matchConditions.notice_date.$gte = filterData.start_notice;
    if (filterData.end_notice) matchConditions.notice_date.$lte = filterData.end_notice;
  }
  // 处理rc_number
  if (filterData.rc_number !== undefined && filterData.rc_number !== null && filterData.rc_number !== '') {
    matchConditions.rc_number = { $eq: filterData.rc_number };
  }
  // 处理circle
  if (filterData.circle !== undefined && filterData.circle !== null && filterData.circle !== '') {
    matchConditions.circle = { $eq: filterData.circle };
  }
  // 处理另一个日期范围（替换成你实际的日期字段名）
  if (filterData.start_date || filterData.end_date) {
    matchConditions.record_date = {};
    if (filterData.start_date) matchConditions.record_date.$gte = filterData.start_date;
    if (filterData.end_date) matchConditions.record_date.$lte = filterData.end_date;
  }
  // 处理status、source等剩余字段
  ['status', 'source', 'sms_status', 'notice_status'].forEach(field => {
    if (filterData[field] !== undefined && filterData[field] !== null && filterData[field] !== '') {
      matchConditions[field] = { $eq: filterData[field] };
    }
  });
}

注意：上面的notice_date和record_date要替换成你集合中实际对应的日期字段名，别直接照搬哦！

3. 重构你的Aggregate查询 #

把动态构建好的matchConditions作为第一个$match阶段，替换原来硬编码的多个$match：

Complaint.aggregate([ 
  { $match: matchConditions }, // 这里用动态生成的条件
  { $lookup:{ 
      from: 'offences', 
      localField:'offences', 
      foreignField: 'offence_id', 
      as: 'offenceSetail' 
    } }, 
  { $project: { 'offences.is_active' : 0 } }, 
  { $replaceRoot : { 
      newRoot : { $mergeObjects : [ { $arrayElemAt: [ "$offenceSetail", 0] }, "$$ROOT"] } 
    } }, 
  { $project: { 'offenceSetail' : 0 } }, 
  { $lookup: { 
      from: 'registers', 
      localField: 'user_id', 
      foreignField: 'id', 
      as: 'sender'
    } }, 
  { $project: { 'sender.is_active' : 0 } }, // 这里修正了原代码的小问题，应该过滤sender里的字段
  { $replaceRoot : { 
      newRoot : { $mergeObjects : [ { $arrayElemAt: ['$sender', 0] }, "$$ROOT"] } 
    } }, 
  { $project: { 'sender': 0 } }, 
  { $facet : { 
      length : [ { $count : "total" }], 
      data : [ { $skip: skip }, {$limit: limit } ] 
    } }, 
])

小提示：原代码里的$project: { 'registers.is_active' : 0 }有问题，因为关联的集合数据存在sender数组里，应该改成'sender.is_active': 0才能正确过滤字段。

为什么这样做？ #

• 动态构建条件能精准实现“有值才过滤，空值就忽略”的需求，不会因为空参数干扰查询结果；
• 把所有匹配规则放到一个$match阶段，比多个$match阶段更高效，MongoDB会一次性处理所有过滤逻辑，减少性能损耗。

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