Laravel迁移无法创建外键的问题排查及解决方案

在Laravel执行数据库迁移时，遇到外键创建失败的错误，报错信息如下：

PDOException::("SQLSTATE[HY000]: General error: 1005 Can't create table laravel.log (errno: 150 \"Foreign key constraint is incorrectly formed\")

初始迁移代码 #

用户迁移

Schema::create('users', function (Blueprint $table) {
    $table->uuid('id');
    $table->string('name');
    $table->string('email')->unique();
    $table->timestamps();
});

日志迁移

Schema::create('log', function (Blueprint $table) {
    $table->uuid('id');
    $table->boolean('statu');
    $table->timestamps();
    $table->foreign('id')->references('id')->on('users')->onDelete('cascade');
});

尝试过的无效修改方式 #

方式一

将外键创建逻辑移至表创建完成后，但问题依旧：

Schema::create('log', function (Blueprint $table) {
    $table->uuid('id');
    $table->boolean('statu');
    $table->timestamps();
});

Schema::table('log', function($table) {
    $table->foreign('id')
        ->references('id')
        ->on('users')
        ->onDelete('cascade');
});

方式二

给日志表id设为主键，新增foreign_id字段用于关联，但仍未解决：

Schema::create('log', function (Blueprint $table) {
    $table->uuid('id')->primary();
    $table->foreignUuid('foreign_id');
    $table->boolean('statu');
    $table->timestamps();
});

Schema::table('log', function($table) {
    $table->foreign('foreign_id')
        ->references('id')
        ->on('users')
        ->onDelete('cascade');
});

最终解决代码 #

问题核心在于users表的id未设置为主键，且初始日志迁移错误地将自身主键作为外键关联用户表，违背数据库关联逻辑。修正后的迁移代码如下：

用户迁移（修正后）

Schema::create('users', function (Blueprint $table) {
    $table->uuid('id')->primary();
    $table->string('name');
    $table->string('email')->unique();
    $table->timestamps();
});

日志迁移（修正后）

Schema::create('log', function (Blueprint $table) {
    $table->uuid('id')->primary();
    $table->foreignUuid('user_id');
    $table->boolean('statu');
    $table->timestamps();
});
Schema::table('log', function($table) {
    $table->foreign('user_id')->references('id')->on('users')->onDelete('cascade');
});

关键修复说明 #

• 给users表的uuid类型id添加->primary()：外键关联要求被关联字段必须是主键或唯一索引
• 日志表新增独立的user_id字段作为外键：避免用自身主键关联用户表，符合"一条日志属于一个用户"的业务逻辑
• 使用foreignUuid确保字段类型与users表的uuid主键完全匹配，避免类型不匹配导致的约束错误

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