Node.js中Sequelize联表查询分页时字段不存在报错

核心原因 #

开启分页（limit/offset）时，Sequelize 默认采用子查询模式：先执行子查询获取主表（Tasks）的ID集合，再基于这些ID关联查询其他表。但你的where条件直接引用了关联表（customer、task_status）的字段，而子查询里并未JOIN这些关联表，MySQL自然找不到对应字段。

无分页时，Sequelize会直接执行全表JOIN后过滤，关联表字段能被正常识别，因此不会报错。

解决方案 #

1. 强制关闭子查询（最直接解决方法） #

在findAndCountAll（或findAll）的配置中添加subQuery: false，让Sequelize使用JOIN方式处理分页，确保关联表在主查询中被加载，where条件里的关联字段就能被正确解析：

const tasks = await Task.findAndCountAll({
  where: {
    [Op.or]: [
      { title: { [Op.like]: `%${search}%` } },
      { '$customer.contact_person_name$': { [Op.like]: `%${search}%` } },
      { '$task_status.name$': { [Op.like]: `%${search}%` } }
    ]
  },
  include: [
    { model: Customer, as: 'customer' },
    { model: TaskStatus, as: 'task_status' }
  ],
  limit: parseInt(pageSize),
  offset: (parseInt(page) - 1) * parseInt(pageSize),
  subQuery: false // 关键配置
});

注意：Sequelize v5及以上版本中，关联表字段需要用$字段名$包裹（比如$customer.contact_person_name$），而非直接写customer.contact_person_name，这也是常见的字段引用错误点。

2. 检查关联关系定义 #

确保Tasks模型与Customers、TaskStatus的关联配置正确，别名必须保持一致：

• Tasks与Customer的关联定义：

Task.belongsTo(Customer, { as: 'customer', foreignKey: 'customer_id' });

• Tasks与TaskStatus的关联定义：

Task.belongsTo(TaskStatus, { as: 'task_status', foreignKey: 'status_id' });

关联的as别名必须和include中的as完全匹配，否则Sequelize无法正确识别关联表。

3. 确认关联表加载模式 #

如果关联表是可选的左连接（required: false），分页时需确保过滤条件不会导致子查询失效。如果必须基于关联表字段过滤，可以设置required: true（内连接），强制关联表被JOIN到主查询中。

验证 #

添加subQuery: false并修正关联字段引用方式后，重新请求带分页参数的API，即可解决Unknown column错误，同时保持跨表搜索和分页功能正常。

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