Spring Boot同一方法保存独立实体仅第二个生效的解决方法

以下是几种针对性的排查和解决方法：

1. 确保方法处于事务管理范围内 #

JPA的持久化操作依赖事务上下文，若方法未被事务包裹，多个save操作可能处于独立的短事务中，导致第一个实体的更新未被正确提交。给方法添加@Transactional注解：

import org.springframework.transaction.annotation.Transactional;

@Transactional
public void updateTwoEntities() {
    firstEntity.setSomething("10");
    firstEntityManager.saveAndFlush(firstEntity);
    
    secondEntity.setFlag(true);
    secondEntityManager.saveAndFlush(secondEntity);
}

该注解会让Spring为方法开启一个全局事务，所有操作在方法结束时统一提交，避免因事务边界问题导致的更新丢失。

2. 检查实体的管理状态 #

如果firstEntity是游离状态（比如从外部传入、或之前的EntityManager会话已关闭），当前EntityManager无法识别其修改。此时需使用merge()方法同步状态：

firstEntity.setSomething("10");
// merge将游离实体的状态同步到持久化上下文
firstEntity = firstEntityManager.merge(firstEntity);
firstEntityManager.flush();

merge()会返回一个受EntityManager管理的实体实例，后续的修改会被正确追踪。

3. 排查乐观锁冲突 #

若实体类使用了@Version注解实现乐观锁，需检查版本号是否匹配。如果修改firstEntity时版本号与数据库中的不一致，JPA会静默跳过更新（不会抛出异常，除非配置了乐观锁异常）。可以查看日志或添加异常捕获，确认是否存在版本冲突。

4. 统一使用同一个EntityManager（同一数据源场景） #

如果两个实体属于同一数据源，没必要使用两个独立的EntityManager。统一注入一个EntityManager操作两个实体，确保所有修改都处于同一个持久化上下文：

@Autowired
private EntityManager entityManager;

@Transactional
public void updateTwoEntities() {
    firstEntity.setSomething("10");
    entityManager.merge(firstEntity);
    
    secondEntity.setFlag(true);
    entityManager.merge(secondEntity);
}

5. 开启SQL日志排查执行情况 #

开启JPA的SQL打印日志，确认第一个实体的更新语句是否被执行。在配置文件中添加：

spring.jpa.show-sql=true
spring.jpa.properties.hibernate.format_sql=true

如果日志中没有出现firstEntity的UPDATE语句，说明EntityManager未检测到实体修改，需回到步骤2检查实体状态。

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