Hibernate中@Transactional场景下merge方法未自动保存变更问题

问题根因 #

1. merge返回值未正确接收使用
   JPA的entityManager.merge(Object entity)方法不会将传入的游离态实例直接纳入持久上下文托管，而是会创建一个全新的持久态托管实例，将传入实例的属性拷贝到新实例后返回。你当前update方法中调用merge后直接丢弃了返回值，后续传给afterUpdate的仍是原始的游离态实例，你在afterUpdate中修改的游离态实例属性无法被持久上下文自动感知。即使你在afterUpdate中再次调用了merge，如果存在后续的事务配置问题，变更依然无法落地。
2. 事务注解配置或生效逻辑异常

• 注解包错误：如果是Spring环境，@Transactional必须使用org.springframework.transaction.annotation.Transactional包下的实现，误用javax.transaction.Transactional会在部分版本中出现事务配置不生效的问题。
• 传播属性配置错误：@Transactional默认传播属性为Propagation.REQUIRED，如果afterUpdate上的注解手动配置了Propagation.NOT_SUPPORTED、Propagation.SUPPORTS等非事务运行属性，会导致afterUpdate运行在无事务环境，merge的变更不会被自动持久化。
• 代理未生效：如果Service类未添加@Service/@Component注解、实例是手动new创建而非从Spring容器获取，会导致AOP代理不生效，所有@Transactional注解都不会生效，事务无法正常启动。

3. 多余的merge调用（错误写法）
   如果update方法正确接收了merge返回的托管实例并传入afterUpdate，则完全不需要再次调用merge：处于持久态的实例的所有属性变更都会被持久上下文自动感知，事务提交时会自动flush到数据库。

修复方案 #

1. 修改update方法，正确接收merge返回的托管实例：

@Transactional
public void update(TEntity entity) {
    TEntity managedEntity = entityManager.merge(entity);
    afterUpdate(managedEntity);
}

2. 简化派生类的afterUpdate实现，删除多余的merge调用：

@Override
public void afterUpdate(Entity managedEntity) {
    managedEntity.setProperties(...);
    // 持久态实例变更会被自动感知，无需手动调用merge
}

3. 检查事务基础配置：

• 确保所有Service类添加@Service注解，所有实例从Spring容器中获取，禁止手动new实例
• 统一使用Spring提供的@Transactional注解，不要混用其他包下的事务注解
• 无需在afterUpdate方法上添加@Transactional注解，该方法会自动加入update方法开启的事务中运行

内容的提问来源于stack exchange，提问作者michal.jakubeczy