Sequelize多表关联查询报错求助：未知列'categoryCategory.category_name'

嗨，我看你碰到了Sequelize多表关联查询的字段找不到问题，别慌，咱们来一步步捋清楚问题出在哪，怎么解决。

首先，这个报错Unknown column 'categoryCategory.category_name' in 'where clause'的核心原因是：你在WHERE条件里引用关联表字段的方式不对，导致Sequelize生成的SQL找不到对应的列。

问题分析 #

你在include里给Category关联设置的别名是categoryCategory，而且模型里的属性是categoryName（对应数据库的category_name字段），但在WHERE条件里你写的是$categoryCategory.category_name$——这里的问题在于，Sequelize对关联字段的解析需要严格匹配，要么用模型的属性名，要么用Sequelize.col()明确指定数据库的表别名+列名，直接写下划线的列名容易识别出错。

另外，你关联了ProductImages（一对多关系），即使加了distinct:true，也可能因为JOIN导致返回重复的Product记录，这个我也顺便给你优化下。

解决方案 #

1. 修正WHERE条件的关联字段引用

推荐用Sequelize.col()方法来明确指定关联表的列名，这样最不容易出错，先记得引入col：

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

然后把WHERE里的关联字段部分改成这样：

[col('categoryCategory.category_name')]: {
  [Op.like]: `%${searchKey}%`,
},
[col('subCategorySubCategory.sub_category_name')]: {
  [Op.like]: `%${searchKey}%`,
},

2. 优化多图片关联的重复记录问题

因为Product和ProductImages是一对多关系，默认JOIN查询会返回多条重复的Product（每条对应一张图片），可以给ProductImages的include加上separate: true，让Sequelize单独查询图片数据，避免重复；同时明确指定distinct基于Product的主键去重：

{
  model: models.ProductImages,
  as: "productImages",
  attributes: ["image"],
  // where: { status: 1 },
  separate: true, // 单独查询图片，避免JOIN导致的重复Product
},

然后在查询配置里加上：

distinct: true,
col: 'Products.id', // 指定基于Product的主键去重

3. 完整修正后的代码

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

return models.Products.findAndCountAll({
  attributes: { exclude: excludedAttributes }, // 排除指定属性
  include: [
    {
      model: models.Category,
      as: "categoryCategory",
      attributes: ["categoryName"]
    },
    {
      model: models.SubCategory,
      as: "subCategorySubCategory",
      attributes: ["subCategoryName"]
    },
    {
      model: models.ProductImages,
      as: "productImages",
      attributes: ["image"],
      // where: { status: 1 },
      separate: true,
    },
  ],
  distinct: true,
  col: 'Products.id',
  limit: parseInt(limit, 10),
  offset: parseInt(offset, 10),
  where: {
    [Op.or]: [
      {
        [col('categoryCategory.category_name')]: {
          [Op.like]: `%${searchKey}%`,
        },
      },
      {
        [col('subCategorySubCategory.sub_category_name')]: {
          [Op.like]: `%${searchKey}%`,
        },
      },
      {
        productName: {
          [Op.like]: `%${searchKey}%`,
        },
      },
      {
        sku: {
          [Op.like]: `%${searchKey}%`,
        },
      },
    ],
  },
  order,
})

额外检查点 #

别忘了确认你的Product模型里的关联定义是否正确，比如belongsTo Category的部分：

// Product模型中的关联定义示例
models.Product.belongsTo(models.Category, {
  as: 'categoryCategory',
  foreignKey: 'category_id', // 这里要和你数据库里的外键字段一致
});

这样应该就能解决你的报错问题，同时优化多图片关联的重复记录问题啦！

备注：内容来源于stack exchange，提问作者ketan pradhan