Sequelize关联排序报错：含SiteService时order子句列不存在

在使用Sequelize查询Site模型时，尝试按关联的Account模型的name字段降序排序，出现如下异常：

• 移除排序条件或注释掉SiteService关联部分时，查询正常执行；
• 同时包含SiteService关联和排序条件时，触发ER_BAD_FIELD_ERROR，提示Unknown column 'account.name' in 'order clause'。

查询代码 #

const sites = await Site.findAndCountAll({
    order: [[{model: Account, as: 'account'}, 'name', 'DESC']],
    limit: limits.limit,
    offset: limits.offset,
    where,
    include: [
        {
            model: Account,
            as: 'account',
            attributes: ['account_id', 'name', 'customer_id'],
            paranoid: false,
            required: true,
            include: [
                {
                    model: Customer,
                    attributes: ['customer_id', 'name'],
                    paranoid: false,
                    required: true,
                },
            ],
        },
        {
            model: Version,
            as: 'versions',
            limit: 1,
            order: [['version_id', 'desc']],
            attributes: ['status', 'config', 'user_id', 'updated_at', 'version_id', 'updated_by', 'is_abtest_parent', 'is_prod'],
            include: [
                {
                    model: User,
                    as: 'updatedByUser',
                    attributes: ['email'],
                    paranoid: false,
                },
            ],
        },
        {
            model: SiteService,
            as: 'services',
            where: siteServiceFilter,
            required: Object.keys(siteServiceFilter).length > 0,
        },
    ],
    distinct: true,
});

模型关联关系 #

Site与Account

Site.belongsTo(models.Account, {
    foreignKey: 'account_id',
    as: 'account'
});

Account.hasMany(models.Site, {
    foreignKey: 'account_id',
    as: 'sites',
});

Site与SiteService

Site.hasMany(models.SiteService, {
    foreignKey: 'site_id',
    as: 'services',
});

SiteService.belongsTo(models.Site, {
    foreignKey: 'site_id',
    as: 'site',
});

问题根源在于distinct: true与一对多关联（Site→SiteService）的组合逻辑：
当启用distinct: true并包含一对多关联时，Sequelize会自动生成嵌套子查询处理分页与去重——先在子查询中获取去重后的Site主键ID，再在外层查询关联其他表拉取完整数据。而你使用的关联模型排序语法[[{model: Account, as: 'account'}, 'name', 'DESC']]仅在子查询中生效，外层查询无法识别该关联引用，导致排序时找不到account.name字段。

方案1：使用明确列引用替换关联模型排序语法 #

将排序条件改为直接指定列名（或用Sequelize.col严谨声明），让Sequelize在生成外层查询时正确关联Account表并引用字段：

// 方式1：直接使用字符串形式
order: ['account.name', 'DESC']

// 方式2：用Sequelize.col明确声明（推荐）
const { Sequelize } = require('sequelize');
order: [[Sequelize.col('account.name'), 'DESC']]

方案2：禁用嵌套子查询，改用扁平JOIN+分组 #

如果业务允许，将distinct: true替换为subQuery: false，强制Sequelize生成扁平JOIN查询，同时通过group by主表主键保证数据唯一性：

const sites = await Site.findAndCountAll({
    order: [[{model: Account, as: 'account'}, 'name', 'DESC']],
    limit: limits.limit,
    offset: limits.offset,
    where,
    include: [/* 原有关联配置 */],
    subQuery: false,
    group: ['site.site_id'] // 替换为你的Site模型主键字段名
});

注意：使用group by时，需确保SELECT的字段要么是分组字段，要么是聚合函数，可能需要调整attributes配置避免SQL语法错误。

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