Spring Boot JPA保存关联表报外键约束失败问题排查

抛出java.sql.SQLIntegrityConstraintViolationException且提示fk_Upis_Musterija1外键校验失败，直接原因是写入Upis表时，字段idMusterija传入的值在关联主表Musterija的主键列idMusterija中无匹配记录。结合预订业务流程，该问题基本由以下几类代码逻辑错误导致：

• 持久化顺序错误：未先将客户信息写入Musterija表生成主键，直接组装Upis记录插入，此时拿到的客户id为null或内存临时值，数据库中无对应记录
• 临时id未替换：前端添加多位客户时，为了做列表渲染生成了临时id作为标识，后端提交时未做处理，直接将临时id作为idMusterija写入Upis
• 持久化框架配置错误：使用JPA/Hibernate时，Upis实体类关联Musterija的属性未配置级联持久化，框架不会自动保存瞬态的客户对象
• 事务逻辑错误：插入客户和插入关联记录的操作不在同一事务中，客户记录插入失败回滚后，关联表插入逻辑仍在执行

按以下顺序排查调整代码即可解决：

1. 调整持久化逻辑执行顺序
   预订提交的核心写逻辑必须严格遵循以下顺序，所有写操作需包裹在同一数据库事务中：

   • 基础参数校验：确认选中餐桌存在、预订时段无冲突、客户信息字段合法
   • 插入预订主记录Rezervacija，获取数据库生成的预订主键
   • 遍历提交的客户列表：
     • 若为已存在客户（可通过手机号、证件号等唯一标识查询），直接取库中对应idMusterija
     • 若为新客户，执行Musterija表插入操作，获取数据库自增/序列生成的真实idMusterija，禁止使用前端传入的id、内存new对象的默认id
   • 用拿到的真实idMusterija、预订id、餐桌id组装Upis复合主键，批量插入Upis表
   • 提交事务

2. 修正JPA实体级联配置
   若使用JPA作为持久层框架，检查Upis实体类的Musterija关联注解，补充级联持久化配置：

   // 错误配置示例：无级联规则，关联瞬态Musterija对象时直接触发外键错误
   @ManyToOne
   @JoinColumn(name = "idMusterija", referencedColumnName = "idMusterija")
   private Musterija musterija;
   
   // 修复后配置
   @ManyToOne(cascade = CascadeType.PERSIST)
   @JoinColumn(name = "idMusterija", referencedColumnName = "idMusterija", nullable = false)
   private Musterija musterija;
   

   注意：如果Repository层是手写SQL实现插入逻辑，上述级联配置不生效，必须手动按第一步的顺序先插入客户拿id。

3. 断点/日志定位异常id
   若调整顺序后仍报错，在Upis插入逻辑前加断点或打印日志，取出所有待写入的idMusterija值，执行如下SQL核对：

   SELECT * FROM Musterija WHERE idMusterija = ?; -- 传入待核对的id值
   

   若查询无结果，顺着id赋值链路向上排查，即可定位到id赋值错误的代码位置。

• 前端新增客户时生成的临时id仅用于页面列表交互，禁止直接透传给后端作为数据库主键使用，后端仅接收客户姓名、联系方式等业务字段即可，主键由数据库生成后返回
• 混合新老客户的预订场景，必须先做客户存在性判断，避免重复插入客户记录，同时避免用错新老客户id
• 所有涉及多表写入的预订逻辑必须加事务控制，避免部分表写入成功、部分表写入失败产生脏数据

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