执行带外键关联的Laravel数据库迁移时报错该如何解决？

你遇到的是Laravel迁移中常见的外键创建失败错误，可按以下步骤排查解决： #

问题原因 #

• 迁移执行顺序不符合依赖要求：tb_store_address表依赖tb_store和tb_city两张父表，如果这两张父表的迁移文件创建时间晚于tb_store_address的迁移，执行时父表还未创建，就会触发外键约束报错。
• 外键关联字段属性不匹配：外键字段和父表被关联字段的类型、长度、属性必须完全一致，比如如果tb_city表的idCity不是int unsigned类型，就会创建失败。
• 数据库引擎不支持外键：MyISAM引擎不支持外键约束，需要使用InnoDB引擎。
• 残留外键名称冲突：如果之前执行过失败的迁移，数据库中残留了同名的外键约束，也会触发创建失败。

解决方案 #

1. 调整迁移执行顺序：检查所有迁移文件的文件名前缀（时间戳部分），确保tb_city、tb_store的迁移时间戳小于tb_store_address的迁移时间戳，保证父表先创建。
2. 核对关联字段属性：确认tb_city表的idCity字段定义为$table->integer('idCity')->unsigned()，和tb_store_address中的对应字段属性完全一致。
3. 指定数据库引擎：在两个迁移的Schema创建逻辑中添加引擎声明，示例如下：

Schema::create('tb_store', function (Blueprint $table) {
    $table->engine = 'InnoDB';
    // 原有字段定义
});

4. 拆分建表与外键创建逻辑：将外键创建单独放到建表之后执行，避免字段未创建就加外键的问题，tb_store_address的迁移修改后参考如下：

Schema::create('tb_store_address', function (Blueprint $table) {
    $table->engine = 'InnoDB';
    $table->string('email', 255);
    $table->integer('cnpj')->unsigned();
    $table->primary(['cnpj', 'email']);
    $table->string('address', 255);
    $table->integer('number')->unsigned();
    $table->integer('phone')->unsigned();
    $table->integer('postalCode')->unsigned();
    $table->string('neighborhood', 255);
    $table->string('complement', 255)->nullable();
    $table->integer('idCity')->unsigned();
});

Schema::table('tb_store_address', function (Blueprint $table) {
    $table->foreign('email')->references('email')->on('tb_store')->cascadeOnDelete();
    $table->foreign('cnpj')->references('cnpj')->on('tb_store')->cascadeOnDelete();
    $table->foreign('idCity')->references('idCity')->on('tb_city')->cascadeOnDelete();
});

5. 如果测试环境允许，可以先执行php artisan migrate:fresh清空原有表结构，再重新执行迁移，避免残留数据影响。

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