Sequelize关联表中findOne与findAll的行为差异及问题排查

问题本质 #

这是Sequelize 6.x版本的已知行为缺陷，并非你的写法错误。当使用findOne+raw: true+主表attributes中引用关联表字段时，Sequelize生成的SQL逻辑会出现错误：将关联表的JOIN放在子查询外部，导致子查询中无法访问关联表字段，触发Unknown column错误。

原因拆解 #

• findAll正常逻辑：先执行JOIN关联表，再筛选字段和条件，SQL结构符合预期。
• findOne错误逻辑：Sequelize会先通过子查询获取主表的单条记录（带LIMIT 1），但子查询中并未JOIN关联表，而你的attributes里引用了manage_brand.id，自然会出现字段不存在的报错。

可行解决方案 #

方案1：用findAll + limit:1替代findOne #

直接沿用findAll的正确写法，添加limit:1限制结果数量，SQL结构与findAll一致，能正常获取带别名的关联字段：

const memberList = await ManageMember.findAll({
  attributes: [
    ['id', 'memberIdx'],
    [Sequelize.col('manage_brand.id'), 'brandIdx'],
  ],
  include: [
    {
      model: ManageBrand,
      attributes: [],
      as: 'manage_brand',
    },
  ],
  where: {
    email: 'test@aaa.aaa',
  },
  raw: true,
  limit: 1,
});
const member = memberList[0]; // 取唯一结果

方案2：在include中定义字段别名并处理结果 #

如果必须使用findOne，可以在关联表的attributes中设置别名，之后手动调整结果结构：

const member = await ManageMember.findOne({
  attributes: [['id', 'memberIdx']],
  include: [
    {
      model: ManageBrand,
      attributes: [['id', 'brandIdx']], // 在此处设置关联字段别名
      as: 'manage_brand',
    },
  ],
  where: {
    email: 'test@aaa.aaa',
  },
  raw: true,
});
// 整理成目标结构
const formattedMember = {
  memberIdx: member.memberIdx,
  brandIdx: member['manage_brand.brandIdx'],
};

方案3：关闭子查询模式（推荐） #

通过添加subQuery: false参数，强制Sequelize先执行JOIN再做LIMIT 1，逻辑与findAll对齐，无需修改字段定义：

const member = await ManageMember.findOne({
  attributes: [
    ['id', 'memberIdx'],
    [Sequelize.col('manage_brand.id'), 'brandIdx'],
  ],
  include: [
    {
      model: ManageBrand,
      attributes: [],
      as: 'manage_brand',
    },
  ],
  where: {
    email: 'test@aaa.aaa',
  },
  raw: true,
  subQuery: false, // 关键参数：禁用子查询
});

补充提示 #

该问题在Sequelize 6.32及以上版本中已被修复，若项目允许，升级到较新版本可直接解决此问题。

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