Laravel迁移外键SQL错误：关联hazard_categories与hazard_videos表遇问题

嘿，我来帮你搞定这个外键关联的SQL错误问题！先给你看正确的迁移代码写法，再拆解几个最容易踩的坑：

正确的hazard_videos迁移代码示例 #

Schema::create('hazard_videos', function (Blueprint $table) {
    // 自定义主键（也可以用默认的id()，看你的业务需求）
    $table->increments('hazard_video_id');
    
    // 重点：外键字段类型必须和父表的hazard_category_id完全匹配
    // 父表用了increments()，对应无符号整数，所以这里要用unsignedInteger()
    $table->unsignedInteger('hazard_category_id');
    
    // 下面是你的业务字段，根据实际需求调整
    $table->string('video_title');
    $table->string('video_url');
    
    $table->timestamps();
    $table->softDeletes();

    // 建立外键约束
    $table->foreign('hazard_category_id')
          ->references('hazard_category_id')
          ->on('hazard_categories')
          // 可选：根据业务需求设置级联规则，比如删除分类时同步删除视频
          ->onDelete('cascade')
          ->onUpdate('cascade');
});

常见错误原因及解决方法 #

• 字段类型不匹配：这是最常见的问题！父表的hazard_category_id是increments()生成的无符号整数，如果子表的外键字段用了普通integer()而不是unsignedInteger()，SQL会直接报错。一定要保证两个字段的类型、长度完全一致。
• 父表未提前创建：如果hazard_videos的迁移文件执行顺序比hazard_categories早，数据库里还没有父表，自然无法创建外键。解决方法是调整迁移文件的文件名前缀（把父表迁移的日期改得更早），或者手动先执行父表的迁移命令：php artisan migrate --path=/database/migrations/xxxx_xx_xx_xxxxxx_create_hazard_categories_table.php
• 数据库引擎不支持外键：MyISAM引擎不支持外键约束，而Laravel默认用的是InnoDB，但如果手动修改过引擎，要确保两个表都使用InnoDB。可以在迁移里显式指定：$table->engine = 'InnoDB';
• 外键约束名称过长：MySQL对约束名称有长度限制，如果自动生成的名称超出限制会报错。这时可以手动指定约束名称：$table->foreign('hazard_category_id', 'hazard_videos_category_fk')
• 父表关联字段不是主键/唯一键：外键必须关联父表的主键或者唯一索引字段，你的父表hazard_category_id是主键，这一点没问题，但如果后续修改过父表结构，也要确认这一点。

如果已经创建了hazard_videos表，添加外键的迁移写法 #

如果hazard_videos表已经存在，只是需要添加外键关联，可以创建一个新的迁移文件：

Schema::table('hazard_videos', function (Blueprint $table) {
    // 先添加外键字段（如果还没添加的话）
    $table->unsignedInteger('hazard_category_id')->after('hazard_video_id');
    
    // 再添加外键约束
    $table->foreign('hazard_category_id')
          ->references('hazard_category_id')
          ->on('hazard_categories')
          ->onDelete('cascade');
});

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