Sequelize多模型查询：主模型与关联模型的OR条件实现

嘿，刚上手Sequelize的话，这种跨模型的OR查询确实容易踩坑，我来给你一步步捋明白怎么改～

首先明确你的核心需求：必须匹配location，同时满足「customers.some_kind_of_string_identifier匹配query」OR「关联users的姓名拼接后匹配query」。原来的代码把关联模型的条件写在include的where里，这会变成AND逻辑，还会自动过滤掉没有匹配关联数据的主模型记录，完全不符合你要的OR效果。

正确实现思路 #

核心是把跨模型的OR条件统一放在主模型的where参数中，同时调整关联模型的include配置，避免不必要的数据过滤。

修改后的代码示例 #

let customers = await db.customers.findAll({
  where: {
    // 固定条件：必须匹配指定location
    location: locationId,
    // 用Op.or包裹两个二选一的查询条件
    [db.Sequelize.Op.or]: [
      // 条件1：customer的标识字段模糊匹配query
      {
        some_kind_of_string_identifier: {
          [db.Sequelize.Op.like]: `%${query}%`
        }
      },
      // 条件2：关联用户的姓名拼接后模糊匹配query
      db.Sequelize.where(
        db.Sequelize.fn(
          'concat',
          db.Sequelize.col('users.first_name'),
          ' ',
          db.Sequelize.col('users.last_name')
        ),
        { [db.Sequelize.Op.like]: `%${query}%` }
      )
    ]
  },
  include: [
    {
      model: db.users,
      required: false, // 关键！设为false表示LEFT JOIN，确保无匹配用户的customer也能被返回
      // 这里不再需要写where，关联条件已整合到主where的OR逻辑中
    }
  ]
});

几个关键细节提醒 #

• 关联字段的完整指定：如果你的关联模型定义时用了as别名（比如as: 'user'），要把users.first_name改成user.first_name，确保Sequelize能正确识别关联表的字段。
• required: false的作用：默认include是INNER JOIN（required: true），会过滤掉没有关联用户的customer。设为false后变成LEFT JOIN，保证只要customer自身匹配query，哪怕没有关联用户也能被查询出来。
• 数据库函数兼容性：如果用的是PostgreSQL而非MySQL，concat函数可能不适用，可改用字符串拼接运算符||，示例如下：

  db.Sequelize.where(
    db.Sequelize.literal(`"users"."first_name" || ' ' || "users"."last_name"`),
    { [db.Sequelize.Op.like]: `%${query}%` }
  )
  

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