Laravel8导入Excel触发MySQL 1452外键约束错误无法插入数据怎么解决？

错误原因 #

这个报错是MySQL外键约束校验失败触发的，核心原因是你向subdistributor表插入的id_dso字段值DSO-ACEH，在关联的父表dso的id_dso字段中不存在匹配的记录，不符合外键关联的一致性要求。

解决步骤 #

• 第一步：校验父表基础数据
  直接在MySQL中执行查询语句：

  SELECT * FROM dso WHERE id_dso = 'DSO-ACEH';
  

  如果查询无返回结果，有两种修复方案：一是先在dso表中插入id_dso为DSO-ACEH的对应记录，再执行导入；二是修改Excel导入文件中的id_dso值为dso表已存在的合法值。
• 第二步：确认关联字段属性一致
  外键关联要求父表和子表的关联字段属性完全一致，你需要确认以下几点：
  1. dso表的id_dso字段类型也是varchar（和subdistributor表的string类型对应），且字段长度完全相同
  2. 两个字段的字符集、排序规则完全一致，字符集不同会导致看似相同的字符串匹配失败
• 第三步：清洗导入的Excel数据
  检查导入文件的id_dso列是否存在前后空格、不可见特殊字符，这类隐藏字符会导致值匹配失败。你可以在SubdistributorImport类中新增map方法做数据清洗，示例如下：

  public function map($row): array
  {
      return [
          'id_subdist' => trim($row['id_subdist']),
          'id_kategori_subdist' => trim($row['id_kategori_subdist']),
          'id_dso' => trim($row['id_dso']),
          // 其他字段按你实际的导入规则补全处理
      ];
  }
  

• 兜底排查：迁移执行顺序
  如果是新环境首次执行迁移，需要保证dso表的迁移文件创建时间早于subdistributor表的迁移文件，否则父表未创建时外键关联不会生效，也可能触发类似报错。

临时调试方案（仅测试用，禁止生产环境使用） #

如果需要快速定位问题，可以临时关闭外键校验，导入完成后再开启，代码调整如下：

// 导入数据前关闭外键校验
\DB::statement('SET FOREIGN_KEY_CHECKS=0;');
Excel::import(new SubdistributorImport, public_path('/file_subdistributor/'.$nama_file));
// 导入完成后恢复外键校验
\DB::statement('SET FOREIGN_KEY_CHECKS=1;');

该方案会跳过数据一致性校验，仅可用于临时测试，不能作为永久解决方案。

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