如何以编程方式构建Mongoose复杂查询？多可选参数场景

嘿，我太懂你这种痛点了——对着40个非必填参数一个个写if判断，简直是重复劳动的噩梦！好在针对你这种带嵌套结构（比如address子对象、subtype数组）的查询参数，有几个简洁且可扩展的方案，能自动帮你构建干净的Mongoose查询对象，再也不用写一堆冗余代码。下面给你详细讲讲：

我们可以写一个递归函数，自动遍历所有层级的参数，过滤掉空值（undefined、null、空字符串、空数组），只保留有有效值的字段，直接转换成Mongoose能识别的查询条件。

function buildMongooseQuery(params) {
  const query = {};

  for (const [key, value] of Object.entries(params)) {
    // 跳过无效空值
    if (value === undefined || value === null) continue;
    if (typeof value === 'string' && value.trim() === '') continue;
    if (Array.isArray(value) && value.length === 0) continue;

    // 处理嵌套对象（比如address）
    if (typeof value === 'object' && !Array.isArray(value)) {
      const nestedQuery = buildMongooseQuery(value);
      // 只有嵌套对象里有有效值才加入查询
      if (Object.keys(nestedQuery).length > 0) {
        query[key] = nestedQuery;
      }
    } else {
      // 数组字段默认用$in（匹配包含任意元素的文档，如需精确匹配数组直接赋值即可）
      query[key] = Array.isArray(value) ? { $in: value } : value;
    }
  }

  return query;
}

// 实际使用示例
const searchQuery = buildMongooseQuery(req.body.searchParams);
const listings = await YourListingModel.find(searchQuery);

这个函数会自动处理你示例里的所有场景：

• publicationType: 'Venta' 会直接加入查询
• subtype: ['Duplex', 'Cabaña'] 会转成{ subtype: { $in: ['Duplex', 'Cabaña'] } }，匹配包含这两种类型之一的文档
• address里的子字段（比如streetNumber: '1312'）会被保留，空的子字段会被自动忽略

如果你的项目已经在用Lodash，可以用它的工具函数进一步简化递归逻辑，不用自己写遍历：

const _ = require('lodash');

function buildMongooseQuery(params) {
  return _.transform(params, (result, value, key) => {
    // 过滤基础空值
    if (_.isNil(value)) return;
    if (typeof value === 'string' && value.trim() === '') return;
    if (Array.isArray(value) && value.length === 0) return;

    // 处理嵌套对象
    if (_.isPlainObject(value)) {
      const nestedQuery = buildMongooseQuery(value);
      if (!_.isEmpty(nestedQuery)) {
        result[key] = nestedQuery;
      }
    } else {
      // 数组字段处理逻辑同上
      result[key] = Array.isArray(value) ? { $in: value } : value;
    }
  }, {});
}

// 使用方式和方案1完全一致
const searchQuery = buildMongooseQuery(req.body.searchParams);
const listings = await YourListingModel.find(searchQuery);

如果某些字段需要模糊搜索（比如address.streetName或city），可以在函数里针对性调整。比如维护一个需要模糊匹配的字段列表，自动转换为$regex条件：

// 在buildMongooseQuery函数里添加
const fuzzyMatchFields = ['streetName', 'city', 'state'];

// 替换原本的else分支逻辑
else {
  if (fuzzyMatchFields.includes(key) && typeof value === 'string') {
    result[key] = { $regex: value.trim(), $options: 'i' }; // 'i'表示忽略大小写
  } else {
    result[key] = Array.isArray(value) ? { $in: value } : value;
  }
}

这样streetName: 'José María Bosch'会自动转成{ streetName: { $regex: 'José María Bosch', $options: 'i' } }，实现模糊匹配。

这两种方案都能一次性搞定所有非必填参数的处理，不管参数是扁平的还是嵌套的，都不用再手动写40个if判断，完全符合你的需求！

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