Spring Data JPA双向关联中版本控制的使用及更新异常解决

这个问题我之前也碰到过，咱们一步步拆解解决：

先搞懂异常原因 #

object references an unsaved transient instance - save the transient instance before flushing 这个报错的核心是：你要更新的TradingAccount关联了一个未被持久化的UnderlyingPerTradingAccount实例（也就是transient游离态对象）。JPA不知道怎么处理这种"父实体关联了一个没存过数据库的子实体"的情况，所以抛出异常。

第一步：修复更新异常——维护双向关联的一致性 #

双向关联的关键是必须同时设置双方的引用，不能只给父实体的集合加子实体，却忘了给子实体设置父实体的引用。

1. 在父实体中添加辅助方法，自动维护关联 #

给TradingAccount加add和remove方法，确保每次修改子实体集合时，同步更新子实体的反向关联：

public class TradingAccount {
    // ... 原有字段
    
    // 初始化集合，避免空指针
    public TradingAccount() {
        this.underlyingPerTradingAccounts = new ArrayList<>();
    }

    public void addUnderlying(UnderlyingPerTradingAccount underlying) {
        this.underlyingPerTradingAccounts.add(underlying);
        underlying.setTradingAccount(this); // 关键：同步设置子实体的父引用
    }

    public void removeUnderlying(UnderlyingPerTradingAccount underlying) {
        this.underlyingPerTradingAccounts.remove(underlying);
        underlying.setTradingAccount(null); // 移除关联时也要同步清空子实体的父引用
    }
}

2. 正确的更新流程 #

不要直接把前端传来的对象丢给JPA更新，正确的步骤是：

1. 从数据库查询出持久态的TradingAccount实例（JPA会跟踪这个对象的状态变化）；
2. 对比新数据，用上面的add/remove方法修改子实体集合；
3. 调用save方法，JPA会自动通过cascade=CascadeType.ALL处理子实体的增删改，同时orphanRemoval=true会自动删除从集合中移除的子实体。

示例Service代码：

@Transactional
public TradingAccount updateTradingAccount(Long accountId, List<UnderlyingPerTradingAccount> newUnderlyings) {
    // 1. 获取持久态的父实体
    TradingAccount existingAccount = tradingAccountRepository.findById(accountId)
            .orElseThrow(() -> new RuntimeException("TradingAccount not found"));
    
    // 2. 清空现有子实体（用remove方法维护双向关联）
    existingAccount.getUnderlyingPerTradingAccounts().forEach(existingAccount::removeUnderlying);
    
    // 3. 添加新的子实体（用add方法自动设置双向关联）
    newUnderlyings.forEach(existingAccount::addUnderlying);
    
    // 4. 保存更新，JPA会自动处理所有关联操作
    return tradingAccountRepository.save(existingAccount);
}

第二步：双向关联中正确使用版本控制 #

你的TradingAccount已经加了@Version注解（乐观锁），但默认情况下，修改子实体集合不会触发父实体的版本号更新——因为JPA默认不会跟踪集合的变化（除非配置了特定属性）。

1. 让父实体版本号随子实体变化而更新 #

最优雅的方式是给子实体集合添加@OrderColumn注解，JPA会跟踪集合的新增、删除、顺序变化，自动更新父实体的version值：

@OneToMany(mappedBy = "tradingAccount", cascade = CascadeType.ALL, orphanRemoval = true)
@OrderColumn(name = "underlying_order") // 需要在数据库的underlying_per_trading_account表中添加underlying_order字段（int类型）
private List<UnderlyingPerTradingAccount> underlyingPerTradingAccounts;

2. 子实体的版本控制（可选） #

如果子实体可能被单独更新，或者需要独立处理并发冲突，可以给UnderlyingPerTradingAccount也加上@Version注解：

public class UnderlyingPerTradingAccount {
    // ... 原有字段
    
    @Version
    private Long version;
}

关键总结 #

• 双向关联必须同时维护双方的引用，这是解决transient异常的核心；
• 利用cascade和orphanRemoval简化子实体的生命周期管理，但前提是关联关系正确；
• 乐观锁@Version要配合@OrderColumn，才能在子实体变化时自动更新父实体的版本号，避免并发冲突。

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