Spring JPA使用@Version实现乐观锁版本大于0时无法更新如何解决

你遇到的版本为1后更新失败的问题，都是@Version字段的使用姿势不对导致的，按下面的步骤排查修改即可：

常见原因 #

• 你在业务代码中手动给version字段赋值了：@Version字段由JPA持久化上下文自动维护，不需要业务代码手动修改，手动赋值会导致版本匹配失败
• 更新时没有先查询最新实体：直接用前端传的脱管实体/自己构造的实体直接更新，实体带的version是旧值，和数据库当前版本匹配不上自然更新失败
• 关联映射配置错误：你实体中@OneToOne的mappedBy = "estate_id"配置需要和关联的SoldEstates实体里的关联属性名完全一致，映射错误会触发意外的级联操作，影响乐观锁校验
• 更新方法没有加事务：非事务环境下每次查询和保存都是独立的持久化上下文，无法正确维护实体状态

修复步骤 #

1. 删掉所有业务代码中调用version的setter方法的逻辑，不要手动修改版本字段的值
2. 更新操作必须遵循「查最新实体→改业务字段→保存」的流程，示例逻辑如下：

@Service
@Transactional
public class EstatesService {
    @Autowired
    private EstatesRepository estatesRepository;

    public Estates updateEstates(long estateId, Estates updateParam) {
        // 先查询数据库中最新的托管态实体
        Estates existEstates = estatesRepository.findById(estateId)
                .orElseThrow(() -> new RuntimeException("对应房产信息不存在"));
        // 仅修改需要更新的业务字段，不要操作version字段
        existEstates.setPlace(updateParam.getPlace());
        existEstates.setPrice(updateParam.getPrice());
        existEstates.setStocks_num(updateParam.getStocks_num());
        existEstates.setSold(updateParam.isSold());
        existEstates.setSold_estate_id(updateParam.getSold_estate_id());
        // 直接保存即可，JPA会自动完成乐观锁校验和版本号递增
        return estatesRepository.save(existEstates);
    }
}

3. 如果确实需要用前端传的脱管实体直接更新，先比对前端携带的version和数据库查询到的最新version，一致后再把业务字段赋值到托管实体上保存即可
4. 确认SoldEstates实体中的关联属性名确实是estate_id，如果不需要全量级联操作，可以把cascade = CascadeType.ALL调整为你实际需要的级联类型，比如cascade = {CascadeType.PERSIST, CascadeType.REMOVE}，避免不必要的级联更新触发版本校验问题

更新时如果版本不匹配会抛出ObjectOptimisticLockingFailureException，捕获该异常给前端返回操作失败请重试的提示即可。

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