Laravel 9执行数据库迁移时外键未创建问题求助

按优先级从上到下逐一验证，90%的同类外键缺失问题都能在前3步定位解决：

1. 检查数据库配置的外键约束开关 #

打开config/database.php，找到connections.mysql配置块，确认foreign_key_constraints参数值为true。如果该值设为false，Laravel会直接跳过所有外键创建语句，不会抛出任何异常，最终仅生成表和普通索引，外键完全不创建。
如果之前缓存过配置，修改后执行php artisan config:clear清除缓存再重试迁移。

2. 确认两张表的存储引擎为InnoDB #

不要只参考全局环境的InnoDB配置，直接打开phpMyAdmin查看supplier_orders、supplier_order_details两张表的表选项，确认实际存储引擎是InnoDB。MyISAM等不支持外键的引擎会静默忽略外键定义，不抛错也不生成外键结构。
如果引擎不符合预期，可以在每个表的迁移定义里强制指定引擎：

Schema::create('supplier_orders', function (Blueprint $table) {
    $table->engine = 'InnoDB'; // 强制指定InnoDB引擎
    $table->increments('Id');
    // 其余字段定义保持原有逻辑即可
});
// supplier_order_details表同理添加$table->engine = 'InnoDB';

3. 确认迁移是全量重新执行 #

如果是第一次跑迁移后才加的外键代码，直接执行php artisan migrate不会生效——Laravel会根据migrations表的执行记录，跳过已经跑过的迁移文件。
本地测试环境直接执行php artisan migrate:fresh（注意：该命令会删除当前数据库所有表后重跑全部迁移，禁止在生产环境执行），再检查外键是否生成。

4. 对齐外键字段与关联主键的属性 #

当前代码逻辑上字段类型是匹配的，但要避免多余传参导致的隐式属性差异：

• 关联主键supplier_orders.Id是$table->increments('Id')生成的无符号INT类型
• 外键字段supplier_order_details.SupplierOrder不要传多余参数，直接定义为$table->unsignedInteger('SupplierOrder')即可，去掉第二个参数false（该参数默认值就是false，手动传参如果位置偏移可能意外修改字段属性）
• 两个字段都保持非空属性，不要出现一个允许为空、一个不允许为空的情况
  调整后的字段定义示例：

// supplier_orders表主键保持原有定义即可
$table->increments('Id');

// supplier_order_details表的外键字段去掉多余参数
$table->unsignedInteger('SupplierOrder');

5. 简化外键定义排查兼容问题 #

先去掉自定义的外键名称，让Laravel自动生成合规的外键名，排除自定义名称长度、特殊字符带来的兼容问题：

Schema::table('supplier_order_details', function (Blueprint $table) {
    $table->foreign('SupplierOrder')
        ->references('Id')
        ->on('supplier_orders')
        ->onDelete('CASCADE');
    // 去掉onUpdate('NO ACTION')，该行为是数据库默认规则，无需显式声明
});

6. 手动执行SQL定位精准报错 #

如果以上步骤都没解决问题，开启Laravel查询日志拿到外键创建的原生SQL语句，复制到phpMyAdmin中手动执行，会直接返回明确的错误原因。外键创建的原生SQL格式参考：

ALTER TABLE `supplier_order_details` 
ADD CONSTRAINT `supplier_order_details_supplierorder_foreign` 
FOREIGN KEY (`SupplierOrder`) REFERENCES `supplier_orders` (`Id`) 
ON DELETE CASCADE;

手动执行时常见的报错包括：

• 字段类型/长度/无符号属性不匹配：按提示修改字段属性保持完全一致即可
• 表排序规则/字符集差异：统一两张表的排序规则为utf8mb4_unicode_ci即可
• 已存在非法数据：如果是带存量数据的表创建外键，要确保外键字段的所有值都在关联主键中存在。

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