Sequelize查询异常：无法筛选指定城市优惠券及无关联优惠券

安全阿岳

2026-5-11

我来帮你解决这个Sequelize查询的问题！你的需求是筛选出两类优惠券：一是关联了city_id=2的优惠券（id1、4），二是完全没有关联任何城市的优惠券（id5）。先分析下你两种写法的问题，再给出正确的实现方式。

问题分析

第一种写法的问题

你尝试在主where里用Op.or结合关联表字段，但有两个关键错误：

判断无关联记录的条件错误：你用了$CouponCities.coupon_id$: null，但coupon_id是coupon_city_map的外键，关联coupons.id，只要关联存在，这个字段就等于优惠券ID，不会为null；而无关联时，整个CouponCities行的所有字段都是null，应该用$CouponCities.id$: null（假设CouponCity表的主键是id）或者$CouponCities.city_id$: null来判断。
可能未正确导入Op操作符：如果没导入const { Op } = require('sequelize')，[Op.or]会被当作普通字符串，导致OR逻辑完全失效，最终只应用了filters里的条件，返回所有符合基础筛选的优惠券。你的生成SQL里没有包含OR条件，也验证了这一点。

第二种写法的问题

你把OR条件放到了include的where里，这会把条件拼到LEFT JOIN的ON子句中，而不是主WHERE子句。更关键的是，coupon_id: null这个条件在coupon_city_map表中是不可能成立的（外键关联了优惠券ID，不会存null），导致ON子句的(zone_id = 1 AND coupon_id IS NULL)永远为假，最终LEFT JOIN后所有CouponCities字段都是null，再加上filters的条件，就返回了所有符合基础筛选的优惠券。

正确写法

这里提供两种可行的实现方式：

方式一：LEFT JOIN + 主WHERE条件（推荐）

通过LEFT JOIN关联城市表，在主WHERE里判断“关联了目标城市”或“无关联记录”，同时加上去重避免重复：

const { Op } = require('sequelize'); // 务必导入Op

let coupons = await Coupon.findAll({
  where: {
    [Op.or]: [
      { '$CouponCities.city_id$': city_id }, // 关联了目标城市的优惠券
      { '$CouponCities.id$': null } // 无任何城市关联的优惠券
    ],
    ...filters // 保留你的其他筛选条件
  },
  include: {
    model: CouponCity,
    attributes: [], // 不需要返回城市表字段
    required: false // 显式指定LEFT JOIN（默认就是false，写出来更清晰）
  },
  attributes: ['id', 'coupon_code', 'discount_per', 'flat_discount', 'discount_upto', 'description', 'display'],
  distinct: true // 去重：避免一个优惠券关联多个城市时返回重复记录
});

生成的SQL会正确包含OR条件：

SELECT DISTINCT `Coupon`.`id`, ... FROM `coupons` AS `Coupon`
LEFT OUTER JOIN `coupon_city_map` AS `CouponCities` ON `Coupon`.`id` = `CouponCities`.`coupon_id`
WHERE (
  `CouponCities`.`city_id` = 2 
  OR `CouponCities`.`id` IS NULL
) 
AND [你的filters条件];

方式二：子查询实现

如果觉得JOIN的方式容易混淆，也可以用子查询直接筛选优惠券ID：

const { Op } = require('sequelize');

let coupons = await Coupon.findAll({
  where: {
    [Op.or]: [
      // 筛选关联了目标城市的优惠券ID
      {
        id: {
          [Op.in]: sequelize.literal(`(SELECT coupon_id FROM coupon_city_map WHERE city_id = ${city_id})`)
        }
      },
      // 筛选无任何城市关联的优惠券ID
      {
        id: {
          [Op.notIn]: sequelize.literal(`(SELECT DISTINCT coupon_id FROM coupon_city_map)`)
        }
      }
    ],
    ...filters
  },
  attributes: ['id', 'coupon_code', 'discount_per', 'flat_discount', 'discount_upto', 'description', 'display']
});

这种写法不需要JOIN，逻辑更直观，也不会有重复记录的问题。

验证结果

两种写法都会正确返回你需要的优惠券：id1（OFFER20）、id4（OFFER40）、id5（OFFER90）。

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