Laravel迁移中将外键类型从int改为UUID时遭遇类型不兼容错误的排查求助

嗨Mike，我看了你的问题，这个报错的原因其实很明确——你只修改了products表的brand_id外键类型，但没有同步修改brands表的id主键类型，外键关联的两端字段类型必须完全一致，现在一边是char(36)，另一边还是原来的int，数据库自然会抛出类型不兼容的错误。而且你的迁移步骤也不够完整，咱们一步步来修正：

问题核心 #

外键约束的规则是：关联的两个字段（子表外键、父表主键）必须拥有完全相同的数据类型、长度和属性。你现在只改了子表的外键，父表主键还是int，这就导致了不匹配。

正确的迁移步骤 #

要完成从int主键到UUID的转换，需要按顺序处理父表（brands）和子表（products），同时要注意数据的迁移（如果表中已有数据的话）：

1. 完整迁移代码示例

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

return new class extends Migration
{
    public function up(): void
    {
        // 全局禁用外键约束，避免迁移过程中触发关联检查
        Schema::disableForeignKeyConstraints();

        // 第一步：处理products表，先移除旧的外键和索引
        Schema::table('products', function (Blueprint $table) {
            // 删除外键约束
            $table->dropForeign(['brand_id']);
            // 删除对应的索引（建议删除后重建，避免索引类型不匹配）
            $table->dropIndex(['brand_id']);
        });

        // 第二步：如果表中有数据，先给brands生成UUID并同步更新products的brand_id
        // 这一步非常重要！跳过会导致数据关联断裂或丢失
        DB::table('brands')->get()->each(function ($brand) {
            $newUuid = Str::uuid()->toString();
            // 更新products表中对应的brand_id
            DB::table('products')
                ->where('brand_id', $brand->id)
                ->update(['brand_id' => $newUuid]);
            // 更新brands表的id为新UUID
            DB::table('brands')
                ->where('id', $brand->id)
                ->update(['id' => $newUuid]);
        });

        // 第三步：修改brands表的主键类型为UUID
        Schema::table('brands', function (Blueprint $table) {
            // 删除旧的主键约束
            $table->dropPrimary('id');
            // 修改id字段为UUID类型（Laravel的uuid()方法自动对应char(36)）
            $table->uuid('id')->change();
            // 重新设置主键
            $table->primary('id');
        });

        // 第四步：修改products表的brand_id为UUID类型，并重建外键
        Schema::table('products', function (Blueprint $table) {
            $table->uuid('brand_id')->change();
            // 重新建立外键约束
            $table->foreign('brand_id')
                ->references('id')
                ->on('brands')
                ->onDelete('cascade'); // 根据你的业务需求设置删除行为
        });

        // 重新启用外键约束
        Schema::enableForeignKeyConstraints();
    }

    public function down(): void
    {
        // 回滚逻辑，按需编写（注意：回滚数据需要提前备份旧的int id）
        Schema::disableForeignKeyConstraints();

        Schema::table('products', function (Blueprint $table) {
            $table->dropForeign(['brand_id']);
            $table->integer('brand_id')->change();
        });

        Schema::table('brands', function (Blueprint $table) {
            $table->dropPrimary('id');
            $table->integer('id')->unsigned()->change();
            $table->primary('id');
        });

        Schema::table('products', function (Blueprint $table) {
            $table->foreign('brand_id')
                ->references('id')
                ->on('brands')
                ->onDelete('cascade');
        });

        Schema::enableForeignKeyConstraints();
    }
};

2. 关键注意事项

• 数据迁移不可忽略：如果你的表中已经有业务数据，一定要先给brands的每条记录生成UUID，同步更新products对应的brand_id，再修改字段类型，否则会导致数据关联断裂。
• 外键约束的禁用与启用：全局禁用外键约束比局部的withoutForeignKeyConstraints更稳妥，避免迁移过程中出现意外的关联报错。
• Laravel版本适配：如果是Laravel 9及以上版本，uuid()方法会自动处理字段类型为char(36)，不需要手动指定长度。
• 备份数据库：在执行这类涉及主键和外键的迁移前，一定要备份数据库，防止数据丢失。

为什么你的原有代码会报错？ #

你只修改了products.brand_id的类型，但brands.id还是int类型，两者类型不匹配，数据库的外键约束检查自然会失败。同时你也没有重新建立外键约束，这也是潜在的问题。

按照上面的步骤调整后，应该就能顺利完成从int到UUID的类型转换啦！

备注：内容来源于stack exchange，提问作者Mike