Spring Boot：如何刷新服务事务中被外部系统调用更新的实体

数据老陈

2026-10-1

问题根因

核心原因是默认@Transactional声明的事务边界内，JPA 持久化上下文（一级缓存）会持有第一次查询到的User实体快照。外部系统直接修改同库的User记录后，当前持久化上下文无法感知数据库侧的变更，后续save操作要么直接覆盖外部系统的修改，要么因乐观锁校验失败无法执行。

推荐解决方案（均无需修改Controller代码，保持业务逻辑内聚在Service层）

方案1：调用外部系统后主动刷新实体（改动最小，适合快速修复）

调用外部系统后，先将过期的实体从持久化上下文中移除，重新查询数据库最新版本的实体，合并你需要修改的字段后再执行保存：

@Service
@RequiredArgsConstructor
public class UserService {
  private final UserRepository userRepository;
  private final ExternalService externalService;
  @PersistenceContext
  private EntityManager entityManager;

  @Transactional
  public UserResponse update(UserRequest userRequest) {
    User user = userRepository.findById(userRequest.getId());
    // 暂存当前请求需要更新的字段
    String targetEmail = userRequest.getEmail();
    // 调用外部系统更新数据库
    externalService.update(user);
    // 清除持久化上下文中的过期实体，重新查最新版本
    entityManager.detach(user);
    User latestUser = userRepository.findById(userRequest.getId());
    // 合并需要更新的字段
    latestUser.setEmail(targetEmail);
    userRepository.save(latestUser);
    return new UserResponse(latestUser);
  }
}

优点：逻辑完全内聚在单个方法内，无额外事务拆分成本，代码改动量极小。

方案2：拆分事务边界，外部调用放在事务外（架构更合理）

外部系统调用属于跨服务操作，本身不应该和本地数据库事务绑定，拆分后可以避免事务持有数据库连接时间过长，同时从根源上避免持久化上下文持有过期实体的问题：

@Service
@RequiredArgsConstructor
public class UserService {
  private final UserRepository userRepository;
  private final ExternalService externalService;

  // 外层方法不加事务，优先执行外部系统调用
  public UserResponse update(UserRequest userRequest) {
    externalService.update(User.builder().id(userRequest.getId()).build());
    // 调用事务方法执行本地更新，注意要通过代理对象调用才会触发事务
    return doSaveUserUpdate(userRequest);
  }

  // 新开独立事务执行查询、更新、保存逻辑
  @Transactional(propagation = Propagation.REQUIRES_NEW)
  public UserResponse doSaveUserUpdate(UserRequest userRequest) {
    User latestUser = userRepository.findById(userRequest.getId());
    latestUser.setEmail(userRequest.getEmail());
    userRepository.save(latestUser);
    return new UserResponse(latestUser);
  }
}

注意：同个类内调用事务方法需要通过Spring代理对象触发，否则事务不生效。可以通过以下两种方式处理：
将doSaveUserUpdate方法移到独立的Bean中管理
启用Spring AOP暴露代理，调用时使用((UserService) AopContext.currentProxy()).doSaveUserUpdate(userRequest)

优点：事务职责清晰，性能更优，适合长期迭代的项目。

方案3：乐观锁+重试机制（适合并发更新场景）

如果你的User实体已经加了@Version乐观锁字段，可以捕获save时抛出的乐观锁异常，重试时重新查询最新实体合并字段后再保存：

@Transactional
public UserResponse update(UserRequest userRequest) {
  int retryCount = 3;
  while (retryCount > 0) {
    try {
      User user = userRepository.findById(userRequest.getId());
      user.setEmail(userRequest.getEmail());
      externalService.update(user);
      userRepository.save(user);
      return new UserResponse(user);
    } catch (ObjectOptimisticLockingFailureException e) {
      retryCount--;
    }
  }
  throw new RuntimeException("用户更新失败，请重试");
}

优点：无需调整事务结构，同时可以避免并发场景下的更新覆盖问题。

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