Sequelize关联配置出现重复外键问题求助

按照Sequelize官方文档的示例，仅在belongsTo关联中指定自定义外键，hasMany端不配置外键：

const Image = sequelize.define('Image', {
  id: {
    type: DataTypes.UUID,
    defaultValue: DataTypes.UUIDV4,
    primaryKey: true
  },
  url: {
    type: DataTypes.STRING,
    allowNull: false
  }
}, {
  tableName: 'Image'
});

Image.belongsTo(Product, {
  foreignKey: {
    name: 'productId',
    allowNull: false
  }
});

Product.hasMany(Image);

但执行后数据库表中会生成两个外键：手动指定的productId和Sequelize自动生成的ProductId，只有在hasMany端也同步指定外键才能解决：

Image.belongsTo(Product, {
  foreignKey: {
    name: 'productId',
    allowNull: false
  }
});

Product.hasMany(Image, {
  foreignKey: 'productId'
});

问题原因 #

Sequelize中belongsTo和hasMany是两个独立的关联定义，尽管它们逻辑上构成一对多关系的两端，但如果两端的外键配置不匹配，Sequelize会将它们视为两个独立的关联，从而生成重复的外键：

• belongsTo端指定外键productId时，会在Image表创建对应外键约束；
• 未指定外键的hasMany端，会按照默认规则生成外键：以源模型名（Product）加Id作为外键名，即ProductId，并创建新的外键约束。

官方文档示例看似无需重复指定，是因为示例中隐含了两端关联的外键配置一致性（比如模型命名规则匹配默认外键生成逻辑），但当使用自定义外键名时，必须在关联的两端同步配置，让Sequelize识别这是同一个关联关系，避免重复生成外键。

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