Laravel 外键约束中自定义主键名称的正确用法-php教程

在 laravel 迁移中，当用户表主键被手动命名为 `user_id` 而非默认 `id` 时，使用 `constrained()` 方法需显式指定关联字段名，否则会因默认查找 `id` 导致外键创建失败；传入 `’user_id’` 作为第二参数是完全正确且符合框架设计的解决方案。

在 Laravel 中，constrained() 是 foreignId() 的便捷封装方法，用于自动建立外键约束并关联到目标表的主键。但它的默认行为假设目标表主键名为 id —— 这在绝大多数场景下成立，却会在你主动修改主键名（如 users 表使用 $table->id(‘user_id’)）时失效。

例如，以下迁移会报错：

// users table
Schema::create('users', function (Blueprint $table) {
    $table->id('user_id'); // 自定义主键名
    $table->string('name');
});

// posts table
Schema::create('posts', function (Blueprint $table) {
    $table->id();
    $table->foreignId('user_id')->constrained('users'); // ❌ 错误！默认查找 users.id
});

Laravel 报错提示类似：SQLSTATE[HY000]: General error: 1005 Can’t create table … (errno: 150 “Foreign key constraint is incorrectly formed”)，本质是外键试图引用不存在的 users.id 字段。

✅ 正确解法正是你发现的写法：

$table->foreignId('user_id')->constrained('users', 'user_id');

这等价于底层调用：