Laravel执行php artisan migrate时MySQL外键约束错误求助

API 探路者

2026-6-18

Laravel迁移外键约束错误（errno:150）解决办法

针对你遇到的SQLSTATE[HY000]: General error: 1005外键约束错误，以下是几种常见的排查和解决方式：

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

外键引用的farmers表必须先于archives表创建。Laravel按迁移文件名的时间戳顺序执行，所以：

查看两个迁移文件的文件名前缀（如2024_05_01_000000_create_farmers_table.php和2024_05_02_000000_create_archives_table.php），确保farmers的时间戳更早。
若顺序颠倒，要么手动修改文件名的时间戳，要么在archives的迁移类中添加依赖声明：

public function up()
{
    Schema::create('archives', function (Blueprint $table) {
        // ... 字段定义
    });
}

public function getDependencies()
{
    return [
        CreateFarmersTable::class,
    ];
}

2. 确保字段类型完全匹配

外键字段farmers_id的类型必须和被引用的farmers.id完全一致：

比如farmers表的id是默认的unsigned bigint，那么archives表的farmers_id需定义为：

$table->unsignedBigInteger('farmers_id');

禁止混用int和bigint，也不要忽略unsigned属性（如果主键是unsigned类型）。

3. 确认表引擎支持外键

MyISAM引擎不支持外键约束，必须使用InnoDB：

在两个迁移文件的表定义中明确指定引擎：

Schema::create('farmers', function (Blueprint $table) {
    $table->engine = 'InnoDB';
    $table->id();
    // ... 其他字段
});

Schema::create('archives', function (Blueprint $table) {
    $table->engine = 'InnoDB';
    $table->id();
    $table->unsignedBigInteger('farmers_id');
    $table->foreign('farmers_id')->references('id')->on('farmers')->onDelete('cascade');
    // ... 其他字段
});