Sequelize关联查询：如何匹配客户或其关联动物的条件

我有一个Customer模型，与Animal模型为一对多关联（models.Customer.hasMany(models.Animal)）。需要实现以下查询需求：

• 返回所有名称（name或lastName）匹配Tes%的客户
• 同时返回自身名称不匹配，但关联动物名称匹配Tes%的客户
• 查询结果需包含客户的名称及关联动物的名称

当前使用的代码仅能返回自身名称匹配的客户，尝试在Customer的where条件中添加{"$Animals.name$": { [Op.like]: searchQuery }}时，提示未知列错误。

要实现需求，需调整查询逻辑，让where条件同时覆盖客户自身和关联动物的匹配场景，同时确保关联表字段能被正确识别。以下是两种可行方案：

方案1：使用子查询判断关联动物匹配 #

通过Op.exists子查询，直接判断当前客户是否存在名称匹配的关联动物，逻辑清晰且不受连接方式限制：

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

Customer.findAll({
    limit: 25,
    where: {
        [Op.or]: [
            { name: { [Op.like]: searchQuery } },
            { lastName: { [Op.like]: searchQuery } },
            // 子查询判断是否存在匹配的关联动物
            {
                [Op.exists]: Animal.findAll({
                    where: {
                        CustomerId: col('Customer.id'),
                        name: { [Op.like]: searchQuery }
                    }
                })
            }
        ]
    },
    attributes: ["id", "name", "lastName"],
    order: [['lastName', 'ASC']],
    include: [
        {
            model: Animal,
            attributes: ["id", "name"],
            required: false, // 左连接，保留所有符合条件的客户
            where: { name: { [Op.like]: searchQuery } } // 仅返回匹配的关联动物
        }
    ]
})

方案2：强制左连接+直接引用关联字段 #

通过subQuery: false强制Sequelize使用左连接而非子查询，此时可以直接在外层where中引用关联表字段：

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

Customer.findAll({
    limit: 25,
    where: {
        [Op.or]: [
            { name: { [Op.like]: searchQuery } },
            { lastName: { [Op.like]: searchQuery } },
            // 直接引用关联表字段（默认别名是模型名复数，即Animals）
            { '$Animals.name$': { [Op.like]: searchQuery } }
        ]
    },
    attributes: ["id", "name", "lastName"],
    order: [['lastName', 'ASC']],
    include: [
        {
            model: Animal,
            attributes: ["id", "name"],
            required: false // 必须用左连接，避免过滤无匹配动物的客户
        }
    ],
    subQuery: false // 关键：强制使用连接查询，让关联表字段可被外层where识别
})

• 原代码的问题：include内的where会提前过滤关联数据，同时外层where仅限制客户自身匹配，导致结果只返回自身名称符合的客户。
• $Animals.name$报错原因：默认情况下Sequelize用子查询处理关联查询，此时关联表字段无法在外层where中直接引用，添加subQuery: false即可解决。

内容的提问来源于stack exchange，提问作者B.T