Sequelize执行迁移时报Cannot add foreign key constraint错误如何解决

问题排查与解决方案 #

1. 优先检查迁移文件执行顺序 #

这是当前报错最可能的诱因：
Sequelize会按照迁移文件名开头的时间戳从小到大依次执行迁移。你在Users表的定义中关联了Plans表作为外键依赖，必须保证Plans表的迁移执行时机早于Users表的迁移。
请检查两个迁移文件的数字前缀：

• 若xxxxxxx-demo-user.js的前缀数字小于xxxxxx-demo-plan.js，则执行时会先尝试创建Users表，此时Plans表还不存在，外键约束无法创建就会抛出报错。
• 解决方法：将Plans迁移文件的前缀数字改得比Users的小，保证先执行Plans表的创建逻辑。

2. 清理历史迁移残留 #

如果之前运行过错误的迁移，数据库中可能残留了不完整的表、外键约束，也会导致后续迁移执行失败：

• 执行回滚命令清理所有已执行的迁移：npx sequelize-cli db:migrate:undo:all
• 也可以直接登录数据库手动删除Users、Plans表以及SequelizeMeta表后，重新执行迁移命令。

3. 检查Model层关联定义 #

迁移逻辑正确的前提下，还要确认Model层的关联配置和外键名一致：

• User模型中需配置：User.belongsTo(models.Plan, { foreignKey: 'PlanId' })
• Plan模型中需配置：Plan.hasMany(models.User, { foreignKey: 'PlanId' })
• 注意外键名的大小写必须和迁移文件中定义的PlanId完全一致，否则也会触发关联异常。

附：格式化后的迁移文件代码 #

migration/xxxxxxx-demo-user.js #

'use strict';
module.exports = {
  up: async (queryInterface, Sequelize) => {
    await queryInterface.createTable('Users', {
      id: {
        type: Sequelize.UUID,
        defaultValue: Sequelize.UUIDV4,
        allowNull: false,
        primaryKey: true
      },
      firstName: {
        type: Sequelize.STRING
      },
      lastName: {
        type: Sequelize.STRING
      },
      email: {
        type: Sequelize.STRING
      },
      phoneNumber: {
        type: Sequelize.STRING
      },
      country: {
        type: Sequelize.STRING
      },
      PlanId: {
        type: Sequelize.UUID,
        references: {
            model: 'Plans',
            key: 'id'
        },
        onUpdate: 'CASCADE',
        onDelete: 'SET NULL',
      },
      password: {
        type: Sequelize.STRING
      },
      createdAt: {
        allowNull: false,
        type: Sequelize.DATE
      },
      updatedAt: {
        allowNull: false,
        type: Sequelize.DATE
      }
    });
  },
  down: async (queryInterface, Sequelize) => {
    await queryInterface.dropTable('Users');
  }
};

migrations/xxxxxx-demo-plan.js #

'use strict';
module.exports = {
  up: async (queryInterface, Sequelize) => {
    await queryInterface.createTable('Plans', {
      id: {
        type: Sequelize.UUID,
        defaultValue: Sequelize.UUIDV4,
        allowNull: false,
        primaryKey: true
      },
      title: {
        type: Sequelize.STRING
      },
      createdAt: {
        allowNull: false,
        type: Sequelize.DATE
      },
      updatedAt: {
        allowNull: false,
        type: Sequelize.DATE
      }
    });
  },
  down: async (queryInterface, Sequelize) => {
    await queryInterface.dropTable('Plans');
  }
};

报错信息 #

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