Sequelize中belongsTo关联外键失效问题排查

你的核心问题是搞反了hasOne和belongsTo的关联逻辑，导致Sequelize生成的JOIN条件不符合预期。

关联规则澄清 #

Sequelize中这两个关联方法的外键位置完全不同：

• A.hasOne(B)：外键会被放在B表中，关联A的主键，代表「A拥有一个B」。
• A.belongsTo(B)：外键放在A表中，关联B的主键，代表「A属于一个B」。

你的场景里，weapon表的mainStatID是关联stat表ID的外键，说明每个Weapon对应一个Stat，且外键在Weapon表中，所以应该用Weapon.belongsTo(Stat)，而非Weapon.hasOne(Stat)。

正确的关联代码 #

// 核心关联：Weapon 关联到 Stat，外键是 Weapon 表的 mainStatID
Weapon.belongsTo(Stat, { foreignKey: 'mainStatID', as: 'mainStat' });

// 若业务需要反向关联（比如通过Stat查对应的Weapon），可添加以下代码（非必须）
Stat.hasOne(Weapon, { foreignKey: 'mainStatID', as: 'weapon' });

为什么原来的代码无效？ #

1. 你之前写的Weapon.hasOne(Stat, { foreignKey: 'mainStatID', as: 'mainStat' })，Sequelize会认为外键mainStatID存在于stat表中，但你的stat表并没有这个字段，所以框架默认用两张表的主键做关联，生成了weapon.ID = mainStat.ID的错误ON子句。
2. Stat.belongsTo(Weapon)无效，是因为它会默认在stat表中寻找weaponID外键，但你的stat表没有该字段，这个关联完全不符合你的业务逻辑。

验证效果 #

当你使用正确的关联后，执行包含mainStat的查询：

Weapon.findOne({
  where: { type: 'polearm' },
  include: 'mainStat'
});

生成的SQL会自动使用正确的JOIN条件：

SELECT [...] FROM `weapon` AS `weapon` LEFT OUTER JOIN `stat` AS `mainStat` ON `weapon`.`mainStatID` = `mainStat`.`ID` WHERE `weapon`.`type` = 'polearm';

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