Laravel迁移新增UUID外键报外键约束格式错误如何解决

需要在users表新增uuid类型字段，迁移代码如下：

Schema::table('users', function (Blueprint $table) {
    $table->uuid('uuid')->nullable()->unique();
});

后续需要在skills表添加关联users.uuid的外键，执行迁移时持续报外键格式错误，对应迁移代码如下：

Schema::table('skills', function (Blueprint $table) {
   $table->foreignUuid('user_id')->nullable();
   $table->foreign('user_id')
         ->references('uuid')
         ->on('users')
         ->onDelete('cascade');
});

相同逻辑在无外键的trainings表中可以执行成功，对应代码如下：

Schema::table('trainings', function (Blueprint $table) {
   $table->foreignUuid('user_id')->nullable();
   $table->foreign('user_id')->references('uuid')->on('users');
});

具体报错信息：

SQLSTATE[HY000]: General error: 1005 Can't create table db_masteremployee.skills (errno: 150 "Foreign key constraint is incorrectly formed") (SQL: alter table skills add constraint skills_user_id_foreign foreign key (user_id) references users (uuid) on delete cascade)

你之前猜测的「新增外键前需要删除表中已有外键」是错误认知，MySQL单表支持配置多个外键约束，不需要提前删除已存在的外键。你在trainings表执行相同代码成功，只是因为该表刚好满足外键创建的所有强制要求，和表上有没有其他外键无关。
报错的errno:150是MySQL外键创建失败的通用错误，本质是外键关联的字段、表不满足InnoDB的外键创建规则，按以下步骤逐一排查即可修复。

• 统一关联字段的类型定义
  不要依赖foreignUuid()方法隐式创建字段，该方法会根据数据库配置生成不同类型的字段，很容易和你手动在users表创建的uuid字段类型不匹配。直接显式用uuid()方法定义字段，保证和users.uuid类型完全对齐，修改skills表迁移代码如下：

  Schema::table('skills', function (Blueprint $table) {
     $table->uuid('user_id')->nullable();
     $table->foreign('user_id')
           ->references('uuid')
           ->on('users')
           ->onDelete('cascade');
  });
  

• 确认表存储引擎支持外键
  MySQL只有InnoDB引擎支持外键约束，trainings是新建表默认使用InnoDB因此创建成功，如果skills是较早创建的历史表，可能被设置为不支持外键的MyISAM引擎。执行以下SQL检查skills表引擎：

  SHOW TABLE STATUS WHERE Name = 'skills';
  

  如果返回结果的Engine字段不是InnoDB，先执行SQL修改引擎：

  ALTER TABLE skills ENGINE = InnoDB;
  

• 确认迁移顺序与被引用字段索引有效
  外键引用的字段必须存在有效索引，你在users表的uuid字段加了unique()约束，会自动创建唯一索引满足要求，但要保证迁移执行顺序正确：必须先跑完给users表新增uuid字段的迁移，再跑skills表加外键的迁移，避免创建外键时被引用字段还不存在。
• 检查字段字符集、排序规则一致
  如果users表和skills表的默认字符集、排序规则不一致（比如一个是utf8mb4_0900_ai_ci，一个是utf8mb4_unicode_ci），就算字段类型都是char(36)，也会触发外键格式错误，建字段时显式指定和被引用字段一致的排序规则即可。

内容的提问来源于stack exchange，提问作者M Andre Juliansyah