Laravel 10迁移失败：求助跳过/移除失败的迁移方案

问题详情 #

我是Laravel和PHP新手，正在搭建基础API，已经创建好Users表，现在需要创建Houses表实现用户与房屋的一对多关联（一个用户对应多套房屋），遇到以下问题：

• 首次编写houses表迁移时用了foreignIdFor('user_id')，执行迁移报错提示找不到user_id
• 修改成foreignId相关写法后，执行迁移还是会调用旧版本代码，一直失败
• 后来创建了第二个迁移文件，用foreignId('user_id')->constrained('users')创建关联，但因为第一个迁移没执行成功，新迁移无法运行
• 试过migrate:reset、migrate:refresh这些命令，甚至修改、删除第一个迁移文件都没用，那个失败的迁移还是会被执行

第一个失败的迁移代码 #

<?php

use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;

return new class extends Migration
{
    /**
     * Run the migrations.
     */
    public function up(): void
    {
        Schema::create('houses', function (Blueprint $table) {
            $table->id();
            $table->foreignIdFor('user_id');
            $table->string('house_title');
            $table->string('house_description');
            $table->string('rent_price');
            $table->string('house_pictures');
            $table->string('facilities');
            $table->string('amenities');
            $table->string('rules');
            $table->string('street');
            $table->string('neighborhood');
            $table->string('city');
            $table->string('state');
            $table->timestamps();
        });
    }

    /**
     * Reverse the migrations.
     */
    public function down(): void
    {
        Schema::dropIfExists('houses');
    }
};

第二个迁移代码 #

<?php

use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;

return new class extends Migration
{
    /**
     * Run the migrations.
     */
    public function up(): void
    {
        Schema::create('houses', function (Blueprint $table) {
            $table->id();
            $table->foreignId('user_id')->constrained('users');
            $table->string('house_title');
            $table->string('house_description');
            $table->string('rent_price');
            $table->string('house_pictures');
            $table->string('facilities');
            $table->string('amenities');
            $table->string('rules');
            $table->string('street');
            $table->string('neighborhood');
            $table->string('city');
            $table->string('state');
            $table->timestamps();
        });
    }

    /**
     * Reverse the migrations.
     */
    public function down(): void
    {
        //
    }
};

解决方法 #

1. 修正foreignIdFor的用法 #

你第一次出错是因为foreignIdFor的参数用错了，这个方法需要传入模型类，不是字段名。正确写法是：

// 关联User模型，自动创建user_id字段并关联users表的id
$table->foreignIdFor(\App\Models\User::class);

这行代码等同于$table->foreignId('user_id')->constrained('users')，两种写法都可以。

2. 彻底清理迁移残留 #

之所以删了旧迁移还会执行，是因为Laravel把迁移记录存在数据库的migrations表里，或者缓存了迁移文件，按以下步骤操作：

• 打开数据库，找到migrations表，删除所有和houses相关的记录（如果有的话）
• 如果数据库里已经有不完整的houses表，直接删掉它
• 删除你创建的第二个迁移文件，只保留一个正确的houses迁移文件
• 清理迁移缓存：执行命令 php artisan migrate:clear
• 最后重新执行迁移：php artisan migrate

3. 正确的Houses表迁移文件示例 #

<?php

use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;

return new class extends Migration
{
    public function up(): void
    {
        Schema::create('houses', function (Blueprint $table) {
            $table->id();
            // 二选一即可，推荐用foreignIdFor写法
            $table->foreignIdFor(\App\Models\User::class);
            // 或者
            // $table->foreignId('user_id')->constrained('users');
            $table->string('house_title');
            $table->string('house_description');
            $table->string('rent_price');
            $table->string('house_pictures');
            $table->string('facilities');
            $table->string('amenities');
            $table->string('rules');
            $table->string('street');
            $table->string('neighborhood');
            $table->string('city');
            $table->string('state');
            $table->timestamps();
        });
    }

    public function down(): void
    {
        Schema::dropIfExists('houses');
    }
};

4. 额外注意事项 #

• 确保Users表的迁移已经执行成功，数据库里确实存在users表
• 迁移文件名的前缀是时间戳，Laravel按时间顺序执行，不要手动修改这个时间戳
• 执行迁移前可以用php artisan migrate:status查看待执行的迁移列表，确认没问题再执行

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