Laravel 11外键约束错误(errno:150)求助：问题排查与修复

问题排查 #

你的代码存在三个核心问题导致外键约束创建失败：

1. 外键字段类型错误：$table->increments('category_id') 是用来创建自增主键的方法，但外键字段仅需普通的无符号整数，且必须与关联表categories的id字段类型完全匹配。categories表用increments('id')创建的是unsigned int类型字段，而increments会自动将字段设为主键，这与外键的用途完全冲突。
2. 迁移执行顺序错误：若expenses表的迁移文件创建时间早于categories，执行迁移时categories表尚未存在，外键关联自然无法建立。
3. 外键语法错误：->on(table:'categories') 和 ->onUpdate(action:'cascade') 是错误的Laravel迁移语法，无需添加table:和action:这类命名参数，直接传递对应字符串即可。

修复方案 #

1. 修改expenses表迁移文件 #

public function up(): void
{
    Schema::create('expenses', function (Blueprint $table) {
        $table->id();
        // 替换increments为unsignedInteger，匹配categories表的id字段类型
        $table->unsignedInteger('category_id');
        // 修正外键定义的语法错误
        $table->foreign('category_id')
              ->references('id')
              ->on('categories')
              ->onDelete('cascade')
              ->onUpdate('cascade');
        $table->decimal('amount', 8, 2); 
        $table->date('entry_date'); 
        $table->timestamps();
        $table->engine = 'InnoDB';
    });
}

2. 确保迁移执行顺序正确 #

• 检查两个迁移文件的文件名前缀（例如2024_05_20_000000_create_categories_table.php和2024_05_21_000000_create_expenses_table.php），categories的文件日期前缀必须早于expenses，Laravel会按日期顺序执行迁移。
• 若顺序错误，可手动修改文件名的日期前缀，或指定顺序执行迁移：

  php artisan migrate --path=database/migrations/[categories迁移文件名].php
  php artisan migrate --path=database/migrations/[expenses迁移文件名].php
  

3. 重置已有错误迁移（可选） #

如果之前已执行过错误迁移导致表结构异常，可先回滚或重置迁移：

# 回滚最后一次迁移操作
php artisan migrate:rollback
# 或重置所有迁移（会清空数据库所有数据）
php artisan migrate:fresh

验证修复 #

执行迁移命令：

php artisan migrate

若未报错，说明外键约束已成功创建。可测试删除或更新categories表的记录，对应的expenses记录会自动删除或同步更新category_id。

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