Sequelize中hasMany与belongsTo关联重复生成外键问题

• 外键名配置不一致：关联关系的两端（hasMany和belongsTo）必须同步指定相同的外键名称，仅在单侧配置时，Sequelize会对另一侧使用默认的驼峰命名规则生成<关联模型名>Id格式的外键，导致同时出现自定义的customer_id和默认生成的customerID两个外键。
• 自动同步策略导致重复外键：如果开启了sequelize.sync({ alter: true })配置，当Sequelize识别到外键配置和数据库已有外键不匹配时，不会自动删除旧的无效外键，只会新增新的外键，多次启动服务就会累积大量重复外键。
• 自定义主键未显式关联：你的Customer模型主键是自定义的customer_id而非默认的id，未显式指定关联的目标主键时，Sequelize也可能出现字段识别错误，生成冗余外键。

第一步：保留模型内的外键字段定义 #

你原来的模型定义是合理的，不需要删除orders表的customer_id字段定义，避免后续字段属性（非空、类型等）不符合预期。

const Customer = sequelize.define(
  "customers",
  {
    customer_id: {
      type: DataTypes.INTEGER,
      autoIncrement: true,
      primaryKey: true,
    },
    first_name: {
      type: DataTypes.STRING,
      allowNull: false,
    },
    last_name: DataTypes.STRING,
  },
  { tableName: "customers" }
);

const Order = sequelize.define(
  "orders",
  {
    order_id: {
      type: DataTypes.INTEGER,
      autoIncrement: true,
      primaryKey: true,
    },
    customer_id: {
      type: DataTypes.INTEGER,
      allowNull: false,
    },
  },
  { tableName: "orders" }
);

第二步：同步配置两侧关联的外键和主键关联 #

两侧关联都必须指定相同的foreignKey，同时显式指定sourceKey和targetKey对应自定义主键，避免默认规则识别错误：

Customer.hasMany(Order, {
  foreignKey: 'customer_id', // 和你定义的外键字段名完全一致
  sourceKey: 'customer_id', // Customer模型的主键字段名
});
Order.belongsTo(Customer, {
  foreignKey: 'customer_id', // 和hasMany配置的外键名完全一致
  targetKey: 'customer_id', // Customer模型的主键字段名
});

第三步：清理现有重复外键+调整同步策略 #

1. 先手动删除数据库orders表中所有重复的外键约束，只保留你需要的customer_id字段对应的外键
2. 开发环境如果可以接受清空表数据，首次启动可以使用sequelize.sync({ force: true })重置表结构，后续启动去掉force参数
3. 不要长期开启alter: true同步，生产环境建议使用Sequelize的迁移脚本管理表结构变更，避免自动同步产生的冗余约束。

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