在Sequelize/Express/Node.js中忽略值为Null的查询参数

你当前通过给每个参数设置默认值来保证查询正常运行，但其实可以通过动态构建查询条件对象的方式，更优雅地忽略用户未传入的参数，避免不必要的默认筛选逻辑，同时让代码更灵活简洁。

核心思路 #

只将用户实际传入的参数（或你明确需要保留默认值的参数）加入where对象，未传入的参数直接跳过，不生成对应的查询条件。

优化后的代码示例 #

// 解构参数：仅给分页这类必须的参数设置默认值，其他参数不强制默认
const { 
  minPrice, maxPrice, city, region, 
  minMeters, maxMeters, minAmbiances, maxAmbiances, 
  minBedrooms, maxBedrooms, minBathrooms, maxBathrooms, 
  minAntiquity, maxAntiquity, isAvailable, propertyType, 
  businessType, parking, orderColumn, orderDirection, 
  page = 1, size = 5 
} = filter;

// 初始化空的查询条件对象
const where = {};

// 处理价格区间：传入minPrice或maxPrice时才添加条件，缺失的一端用合理默认值
if (minPrice !== undefined || maxPrice !== undefined) {
  where.price = {
    [Op.between]: [Number(minPrice || 0), Number(maxPrice || 1000000000)]
  };
}

// 处理城市模糊查询：仅当传入city且不为空时添加条件
if (city) {
  where.city = { [Op.like]: `%${city}%` };
}

// 处理地区模糊查询
if (region) {
  where.region = { [Op.like]: `%${region}%` };
}

// 处理面积区间
if (minMeters !== undefined || maxMeters !== undefined) {
  where.sqMeters = {
    [Op.between]: [Number(minMeters || 0), Number(maxMeters || 1000000000)]
  };
}

// 处理房间数、卫生间数等区间字段，逻辑一致
if (minAmbiances !== undefined || maxAmbiances !== undefined) {
  where.ambiances = {
    [Op.between]: [Number(minAmbiances || 0), Number(maxAmbiances || 100)]
  };
}

if (minBedrooms !== undefined || maxBedrooms !== undefined) {
  where.bedrooms = {
    [Op.between]: [Number(minBedrooms || 0), Number(maxBedrooms || 100)]
  };
}

if (minBathrooms !== undefined || maxBathrooms !== undefined) {
  where.bathrooms = {
    [Op.between]: [Number(minBathrooms || 0), Number(maxBathrooms || 100)]
  };
}

if (minAntiquity !== undefined || maxAntiquity !== undefined) {
  where.antiquity = {
    [Op.between]: [Number(minAntiquity || 0), Number(maxAntiquity || 100000)]
  };
}

// 处理等值匹配字段：仅当参数存在时加入查询条件
if (isAvailable !== undefined) where.isAvailable = isAvailable;
if (propertyType) where.propertyType = propertyType;
if (businessType) where.businessType = businessType;
if (parking !== undefined) where.parking = parking;

// 处理排序：仅同时传入排序字段和方向时才设置排序，否则用默认规则
const order = [];
if (orderColumn && orderDirection) {
  order.push([orderColumn, orderDirection]);
}

// 执行查询，修正分页offset计算（原逻辑会导致第一页跳过数据）
const result = await properties.findAll({
  where,
  order: order.length ? order : [['id', 'ASC']], // 可选：设置默认排序规则
  limit: Number(size),
  offset: Number(size) * (Number(page) - 1)
});

关键改进点 #

• 动态条件构建：未传入的参数不会出现在where对象中，避免了默认值带来的无效筛选（比如原逻辑中city=""会生成like "%%"，现在没传city就不会筛选城市）。
• 灵活的默认值控制：区间类参数仅在用户传入其中一个值时启用筛选，同时给缺失的一端设置合理默认，兼顾灵活性和业务需求。
• 排序逻辑优化：只有当同时传入排序字段和方向时才自定义排序，否则使用默认规则。
• 分页逻辑修正：修正了原代码中offset计算错误的问题，确保分页结果正确。

进一步简化（可选） #

如果有大量区间类参数，可以封装工具函数减少重复代码：

function addBetweenCondition(where, field, minVal, maxVal, defaultMin, defaultMax) {
  if (minVal !== undefined || maxVal !== undefined) {
    where[field] = {
      [Op.between]: [Number(minVal || defaultMin), Number(maxVal || defaultMax)]
    };
  }
}

// 使用示例
addBetweenCondition(where, 'price', minPrice, maxPrice, 0, 1000000000);
addBetweenCondition(where, 'sqMeters', minMeters, maxMeters, 0, 1000000000);
// ...其他区间字段

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