Spring Boot REQUIRES_NEW内层事务提交后外层重复插入主键冲突如何解决

问题根本原因 #

你的推测是正确的，问题核心是两层事务对应独立的Hibernate持久化上下文（Session）：

1. 外层事务加载的User实体是托管在外层Session的持久化上下文中
2. 实体传入内层REQUIRES_NEW事务时，内层会创建独立Session，修改并保存实体后，内层Session随事务提交关闭
3. 外层持有的User实体对象的属性已经被内层修改，但外层持久化上下文完全不知道这些变更已经在内层被持久化到数据库，事务提交时触发脏检查，识别到User的profile属性有变更，会再次执行级联插入操作，触发唯一键冲突。

解决方案 #

方案1：处理完成后将实体从外层持久化上下文移除 #

内层执行完成后，手动调用EntityManager#detach方法把处理过的User实体从外层持久化上下文移除，外层提交时不会再对这些实体做脏检查和持久化操作。
代码示例：

// 注入EntityManager
@PersistenceContext
private EntityManager entityManager;

@Transactional
public void processUsers() {
    List<User> users = repo.getUsers();
    processPart.processPart(users);
    // 移除所有处理过的实体
    users.forEach(entityManager::detach);
}

适用场景：不想修改内层逻辑，外层不需要再使用这些User实体的后续变更。

方案2：内层事务独立查询实体处理 #

不要把外层加载的脱管实体传入内层，改为传入用户ID，内层事务内部重新查询对应User实体再做修改。这样不会修改外层持有的实体属性，外层脏检查不会触发额外操作。
代码示例：

// 外层传ID而非实体
@Transactional
public void processUsers() {
    List<User> users = repo.getUsers();
    List<Long> userIdList = users.stream().map(User::getId).toList();
    processPart.processPart(userIdList);
}

// 内层通过ID查询自己Session内的托管实体
@Transactional(propagation = Propagation.REQUIRES_NEW)
public void processPart(List<Long> userIds) { 
    List<User> innerUsers = repo.findAllById(userIds);
    innerUsers.forEach(user -> user.setProfile(new Profile(user)));
    repo.saveAll(innerUsers);
}

适用场景：内层逻辑可以调整，外层后续还需要使用最初加载的User实体状态。

方案3：调整事务传播机制（业务允许时优先选） #

如果业务没有要求内层事务必须独立提交，把内层的事务传播级别改为默认的Propagation.REQUIRED，让内层加入外层事务，两层共用同一个Session，就不会出现持久化上下文状态不一致的问题。
代码示例：

// 改为默认传播级别，加入外层事务
@Transactional(propagation = Propagation.REQUIRED)
public void processPart(List<User> users) { 
    users.forEach(user -> user.setProfile(new Profile(user)));
    repo.saveAll(users);
}

适用场景：没有要求内层事务独立提交、独立回滚的场景，代码改造成本最低。

方案4：外层加载后直接脱管实体 #

外层查询到User实体后，立刻将这些实体从外层持久化上下文脱管，后续所有修改都在内层处理，外层不会感知到实体变更。
代码示例：

@PersistenceContext
private EntityManager entityManager;

@Transactional
public void processUsers() {
    List<User> users = repo.getUsers();
    // 加载后立刻脱管
    users.forEach(entityManager::detach);
    processPart.processPart(users);
}

适用场景：外层不需要对这些实体做任何后续持久化操作。

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