Laravel调用save()报错外键违反：country_code不存在于country表

报错核心原因：数据库层外键校验不通过，写入society表的country_code值HUN未在关联的country表code字段中找到匹配记录，按以下顺序逐层排查即可定位问题：

1. 先校验基础数据一致性 #

• 直接执行SQL查询确认country表中是否存在目标记录：

  SELECT code, LENGTH(code) FROM country WHERE code LIKE '%HUN%';
  

  重点排查两类脏数据问题：一是值存在前后缀空格、全半角字符差异、大小写不匹配（比如存的是hun、HUN 这类肉眼难识别的异常值），字符串类型外键是严格逐字符匹配的；二是确认code字段值长度和HUN（3位）一致，避免存在不可见字符。
• 校验保存操作传入的country_code值类型：确保传入的是字符串格式的三位国家码，避免传入数字0、布尔值false、空字符串这类会被隐式转换的异常值。

2. 校验数据库实际外键配置（不要只看迁移代码） #

• 迁移代码写对不代表数据库实际生效，直接查询表结构确认外键真实配置，MySQL环境执行：

  SHOW CREATE TABLE society;
  

  在输出的外键定义部分确认三个配置项：
  • 外键绑定的源字段确实是society.country_code
  • 关联的目标表确实是country，目标字段确实是code
  • 两个关联字段的字符集、排序规则完全一致：如果society.country_code是utf8mb4_0900_ai_ci、country.code是utf8mb4_unicode_ci，即使值完全相同，数据库也会判定为不匹配触发外键报错。
• 排查迁移执行顺序问题：如果给society表加外键的迁移执行时间早于country表设置code为主键的迁移，会导致外键关联配置异常，需要调整迁移时间戳顺序后重新执行迁移。

3. 校验模型层逻辑 #

• 当前Society模型中country()的belongsTo关联定义语法正确，额外检查Society模型的$fillable属性，确认country_code在可批量赋值列表中，避免框架自动过滤字段导致写入异常值。
• 排查模型修改器、观察者、模型事件逻辑：在执行save()前打印$society->country_code的实际值，确认没有前置逻辑偷偷篡改字段值。
• 如果使用了数据库事务，确认country表中code=HUN的记录在当前事务中已经提交，未提交的事务数据对外键校验不可见，会触发报错。

4. 特殊场景排查 #

• 多库/多schema环境下，确认外键关联的country表和你业务查询用的country表是同一连接下的同一张表，避免跨库关联指向了空的备份表/测试表。
• 外键是数据库层逻辑，和模型软删除无关：只要code=HUN的记录物理存在于country表，即使被软删除标记也不会触发报错；如果之前物理删除过该条国家记录，就会出现当前报错。
• 检查society.country_code字段的默认值配置，如果默认值是无效国家码，新建记录未传该字段时会自动写入无效值触发报错。

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