Spring MVC JPA保存实体报Hibernate乐观锁异常排查

问题背景 #

• 基于Spring MVC的Java项目使用JPA/Hibernate，定义TariffeBaseComposizioni、TipiComposizioni两个实现Serializable接口的JPA实体
• TariffeBaseComposizioni通过@ManyToOne配置与TipiComposizioni的关联，表外键TARIFFE_BASE_COMPOSIZIONI.TIPO_COMPOSIZIONE关联TIPI_COMPOSIZIONI.SIGLA字段，其中TIPI_COMPOSIZIONI表以ID为主键、SIGLA为唯一自然键
• 调用getCurrentSession().save(t)保存TariffeBaseComposizioni实例t时抛出HibernateOptimisticLockingFailureException，执行日志显示Hibernate先执行insert插入TARIFFE_BASE_COMPOSIZIONI记录，随后立即执行同表同记录的update语句，最终抛出嵌套异常StaleStateException：批量更新返回行数不符合预期，实际更新0行，预期更新1行
• 提前从数据库查询携带完整id的TipiComposizioni实体再做关联可以临时解决问题

核心问题解答 #

1. 异常触发的根本原因 #

根本原因是Hibernate对关联对象的状态判定逻辑和实际关联逻辑不匹配：
Hibernate默认通过实体标注了@Id的主键字段判断对象状态：只要主键为null，就会被判定为未入库的瞬时态新对象。传入的关联TipiComposizioni实例只设置了自然键SIGLA、主键id为null，Hibernate会把它当成需要持久化的新对象处理，而不是已存在的关联引用。后续Hibernate生成的更新语句预期要更新刚插入的TariffeBaseComposizioni记录的关联ID，但实际外键存的是SIGLA值，更新条件匹配不到任何行，最终抛出乐观锁异常。

2. 调整注解配置的解决方案 #

不需要每次提前查库加载完整实体，通过以下注解调整即可解决：

• 最稳妥的方案是将关联配置和外键字段映射拆开，明确告诉Hibernate不需要级联操作关联对象，直接使用传入的SIGLA值作为外键写入：

// 只读的关联对象，不参与insert/update
@ManyToOne(fetch = FetchType.LAZY)
@JoinColumn(name = "TIPO_COMPOSIZIONE", referencedColumnName = "SIGLA", insertable = false, updatable = false)
private TipiComposizioni tipiComposizioni;

// 直接映射外键字段，业务层只需要给这个字段set对应的SIGLA值即可
@Column(name = "TIPO_COMPOSIZIONE")
private String tipoComposizioneSigla;

• 如果不想单独拆字段，需要显式关闭@ManyToOne的所有级联操作，避免Hibernate尝试持久化仅设置了SIGLA的瞬时态TipiComposizioni实例，同时给TipiComposizioni的SIGLA字段加上@NaturalId注解，让Hibernate识别该自然键的关联逻辑。

3. serialVersionUID对save持久化流程的影响 #

实体类定义的serialVersionUID完全不会影响Hibernate的持久化流程：
serialVersionUID是Java原生序列化机制的版本校验标识，仅在JVM对对象做序列化/反序列化时生效，用来校验序列化前后类版本是否一致。Hibernate的持久化逻辑是通过反射读取实体字段值生成并执行SQL，全程不会触发Java原生序列化流程，因此无论是否定义serialVersionUID、取值是什么，都和save等持久化操作无关。

4. insert后立即触发同记录update的原因 #

这个现象是Hibernate持久化上下文的执行顺序和脏检查机制导致的：

1. 调用save(t)时，Hibernate首先判定TariffeBaseComposizioni是瞬时态对象，先生成insert语句写入基础字段值，插入完成后t就变为受持久化上下文管理的持久态对象
2. 后续flush阶段执行脏检查时，Hibernate发现t关联的TipiComposizioni是id为null的瞬时态对象，按照默认的关联处理逻辑（或配置的级联规则），会先尝试持久化这个关联的TipiComposizioni新对象
3. Hibernate认为关联对象持久化后，需要把新生成的TipiComposizioni主键ID更新到t的关联外键字段上，因此针对刚插入的t记录生成update语句
4. 但实际外键关联的是TipiComposizioni的SIGLA字段而非主键ID，这个update语句的匹配条件找不到对应记录，最终返回更新行数为0，触发异常。

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