Laravel 9使用foreignId时出现外键约束格式错误问题求助

问题重现 #

Products 迁移代码 #

Schema::create('product', function (Blueprint $table) {
    $table->id(); // 产品ID
    $table->string('name'); // 产品名称
    //$table->unsignedBigInteger('category_id');
    $table->foreignId('category_id')->constrained('category');
    $table->timestamps();
});

Category 迁移代码 #

Schema::create('category', function (Blueprint $table) {
    $table->id();
    $table->integer('main_category')->nullable();
    $table->string('name');
    $table->integer('commission');
});

错误信息 #

General error: 1005 Can't create table laravel.product (errno: 150 "Foreign key constraint is incorrectly formed")

错误原因及解决方法 #

1. 迁移执行顺序错误（最常见原因） #

外键约束要求被引用的category表必须先于product表创建。Laravel 按迁移文件名的时间戳顺序执行迁移，若product迁移文件的时间戳更早，就会触发该错误。

解决方法：

• 调整文件名时间戳：修改product迁移文件的开头时间戳，让它晚于category迁移文件的时间戳。例如category迁移文件为2024_05_01_000000_create_category_table.php，product迁移文件改为2024_05_02_000000_create_product_table.php。
• 指定迁移依赖：在product迁移类中添加getDependencies方法，强制Laravel优先执行category迁移：

public function getDependencies()
{
    return [
        \Database\Migrations\CreateCategoryTable::class, // 替换为你的Category迁移类名
    ];
}

• 单独执行迁移：先手动执行category迁移，再执行全部迁移：

# 先执行category迁移
php artisan migrate --path=database/migrations/2024_05_01_000000_create_category_table.php
# 再执行所有迁移
php artisan migrate

2. 字段类型不匹配（次要检查项） #

确认category表的id字段与product表的category_id字段类型一致：两者默认使用unsignedBigInteger类型（id()和foreignId()的默认类型），若手动修改过字段类型需调整回匹配状态。

3. 字符集/排序规则不一致（罕见情况） #

若两个表的字符集或排序规则不同，也可能触发约束错误。可在迁移中统一指定：

// 在category和product的迁移闭包内添加
$table->charset = 'utf8mb4';
$table->collation = 'utf8mb4_unicode_ci';

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