Sequelize迁移报errno150外键约束格式错误该如何解决

错误原因 #

触发该错误的常见原因有以下几点，结合你给出的代码可以逐一排查：

• 外键字段配置了onDelete: "SET DEFAULT"但未设置对应的defaultValue属性，同时关联的Userstatus表中也没有预先插入对应默认值的有效记录，数据库无法找到合法的默认值完成约束配置
• 外键字段statusId与被引用的Userstatus.id字段属性不完全匹配：如果任意一侧配置了unsigned、不同字符集/排序规则等属性，都会触发外键创建失败
• 关联表名不匹配：Sequelize默认会将模型名转为复数作为表名，如果你没有手动指定Userstatus的表名为Userstatus，那么实际生成的表名应为userstatuses，此时references.model配置的Userstatus指向不存在的表
• 数据库使用了不支持外键的存储引擎（如MyISAM），需要切换为InnoDB
• 补充：你当前的Userstatus迁移文件中缺失了createdAt、updatedAt字段，虽然不是本次报错的直接原因，但不符合Sequelize模型的默认配置，后续操作可能会触发异常

解决方案 #

按照以下步骤修改即可解决问题：

1. 修正Users迁移中statusId字段的配置，补充默认值，调整外键动作：
   如果要保留SET DEFAULT逻辑，先给statusId添加默认值配置，示例：

statusId: {
  type: Sequelize.TINYINT,
  allowNull: false,
  defaultValue: 1, // 对应Userstatus表中init状态的id
  references: {
    model: "Userstatus",
    key: "id",
  },
  onUpdate: "CASCADE",
  onDelete: "SET DEFAULT",
}

如果不需要SET DEFAULT逻辑，可以改成更常用的RESTRICT（禁止删除被关联的状态记录）或者SET NULL（需要同时设置allowNull: true）。

2. 确认Userstatus.id和statusId的字段属性完全一致，比如如果Userstatus.id加了unsigned: true，statusId也要添加相同的配置。

3. 确保关联表名正确：如果没有手动指定Userstatus的表名，将references.model改为自动生成的复数表名userstatuses，或者在Userstatus模型中显式指定表名：

// models/userstatus.js 中添加配置
module.exports = (sequelize, DataTypes) => {
  const Userstatus = sequelize.define('Userstatus', {
    // 原有字段定义
  }, {
    tableName: 'Userstatus', // 显式指定表名和迁移中配置一致
    timestamps: true // 如果你删除了默认的createdAt、updatedAt字段可以设为false，或者在迁移中补上对应字段
  });
  return Userstatus;
};

4. 在Userstatus的迁移up函数建表逻辑末尾补充默认状态数据的插入，确保默认值对应的记录存在：

// migrations/xxxxxxxxxxxxx1-create-userstatus.js 的up函数内，建表完成后添加
await queryInterface.bulkInsert('Userstatus', [
  { id: 1, name: 'init', comment: '初始状态' },
  { id: 2, name: 'active', comment: '活跃状态' },
  { id: 3, name: 'inactive', comment: '禁用状态' }
], {});

修改完成后重新执行迁移命令即可正常创建外键约束。

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