新增Usuarios表用户触发外键约束失败 表关联问题排查

报错Cannot add or update a child row: a foreign key constraint fails的核心原因非常明确：你写入Usuarios表的dni字段值，无法在关联的Medicos表dni主键列中找到完全匹配的记录，按以下优先级逐一排查即可定位问题：

• 优先校验控制器拿到的表单实际传值
  先在u.setDni(request.getParameter("txtDni"))这行代码前后加打印，输出拿到的参数实际值，这类偶发失效80%以上都是传值环节出问题：
  • 检查前端表单中txtDni输入控件：如果控件加了disabled属性，提交时不会携带该参数，后端拿到的是null；如果控件name属性被误改，后端同样拿不到正确值
  • 检查传入值是否存在隐形格式问题：比如前后带多余空格、大小写和Medicos表中存储的dni不一致——MySQL外键对字符串是严格精确匹配，多一个空格、字母大小写不同都会判定为不匹配
  • 如果你创建的是非医生类用户（比如管理员、普通患者），注意不要给dni传空字符串""：你的表结构中dni允许为NULL，非医生用户应该直接传null，空字符串会被MySQL当作有效字符串去Medicos表匹配，自然找不到对应记录触发报错，这也是功能初期正常、后续扩展用户类型后容易踩的坑
• 校验关联表数据是否存在
  拿到后端实际接收到的dni值后，直接在数据库执行以下查询验证对应医生记录是否存在：

  SELECT dni FROM Medicos WHERE dni = '替换成你实际拿到的dni值';
  

  如果查询无结果，说明对应医生记录已经被删除、或者dni字段被修改过，关联关系自然失效。
• 校验字段配置一致性
  如果确认传入的dni值在Medicos表中确实存在，就检查两个表dni字段的字符集、排序规则是否一致，执行以下语句查看字段配置：

  SHOW FULL COLUMNS FROM Usuarios LIKE 'dni';
  SHOW FULL COLUMNS FROM Medicos LIKE 'dni';
  

  两个字段的Collation（排序规则）值必须完全相同，比如一个是utf8mb4_general_ci、另一个是utf8mb4_bin，就会出现肉眼看值完全一致，但数据库校验判定不匹配的问题。

快速验证小技巧：你可以先手动在数据库里执行INSERT语句插入一条测试用户数据，把dni值写死成一个确定在Medicos表里存在的dni，如果插入成功，就100%是后端接收到的表单传值有问题，不用再排查表结构配置。

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