Node+Express+MongoDB二次筛选req.query为undefined搜索异常问题咨询

问题根源 #

你将三个筛选字段硬编码到了查询结构中，就算字段没有有效值，MongoDB也会执行对应匹配逻辑，要么匹配undefined、要么匹配空正则，自然得不到预期结果。

解决思路 #

通过白名单动态构建查询条件，仅当字段有有效值时才将其加入查询语句，同时避免直接使用全部req.query参数带来的安全问题。

实现代码 #

// 正则特殊字符转义函数，避免用户输入特殊字符导致正则异常
function escapeRegExp(string) {
  return string.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')
}

// 1. 初始化基础查询，仅保留主搜索框的文本搜索条件
const query = {
  $text: { $search: req.query.search }
}

// 2. 定义二次筛选的字段白名单，后续新增筛选字段仅需修改该数组
const allowFilterFields = ['name', 'email', 'city']

// 3. 遍历白名单字段，有有效值才生成对应筛选条件
const filters = allowFilterFields.reduce((acc, field) => {
  const fieldValue = req.query[field]?.trim()
  if (fieldValue) {
    acc.push({ [field]: { $regex: `^${escapeRegExp(fieldValue)}` } })
  }
  return acc
}, [])

// 4. 存在筛选条件时才合并到主查询中，没有筛选条件时直接查询主搜索结果
if (filters.length) {
  // 多筛选项需同时满足用$and，满足任意一个用$or，可根据业务需求调整
  query.$and = filters
}

// 5. 直接使用动态生成的query执行查询
collection.find(query).toArray(/* 原有回调逻辑 */)

方案说明 #

• 不需要写多个重复的if判断，新增筛选字段只需往allowFilterFields数组添加字段名即可，维护成本极低
• 无有效值的字段完全不会出现在查询条件中，从根源避免了匹配undefined或空正则的问题
• 通过白名单控制可筛选字段，不会直接使用全部req.query参数，避免恶意参数传入查询，符合你的安全要求

之前方案失效的原因 #

你将undefined赋值为空字符串后，生成的正则是{$regex: "^"}，该规则会匹配所有存在对应字段的文档，相当于额外加了{字段名: {$exists: true}}的限制，会过滤掉没有对应字段的文档，同时会增加不必要的查询开销，不如直接不加入查询条件高效。

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