Spring JPA通过非主键执行部分更新时出现异常问题

核心结论 #

完全可以通过唯一非主键field2执行部分更新，你当前遇到的ObjectOptimisticLockingFailureException是乐观锁冲突导致的，和使用非主键触发更新的逻辑无关。

异常原因解析 #

从异常栈的SQL语句update my_model set field1=? where id=? and version=?可知，你的MyModel实体应该添加了@Version乐观锁注解。出现更新行数为0的原因通常有两种：

• 查询出实体后，该数据被其他线程/进程修改并更新了版本号，导致你执行save时，数据库中已不存在id=? and version=?的匹配记录
• 查询得到的实体的version字段值异常（比如为null，或与数据库实际存储的版本值不匹配）

具体解决方案 #

方案1：修复乐观锁问题，保留查询-更新-保存流程 #

1. 检查MyModel的version字段映射，确保查询时能正确获取数据库中的版本值（比如字段是否加了@Version注解，类型是否匹配）
2. 若业务允许，可捕获ObjectOptimisticLockingFailureException并执行重试逻辑，避免并发更新导致的失败
3. 如果业务场景不需要乐观锁，可直接移除实体上的@Version注解（不推荐高并发场景使用，可能导致数据覆盖）

方案2：直接基于field2执行部分更新（无需先查询实体） #

这种方式更高效，避免查询实体带来的并发风险，直接在Repository中定义更新方法：

public interface MyRepo extends JpaRepository<MyModel, UUID> {
    Optional<MyModel> findByField2(String value);

    // JPQL方式：仅更新指定字段
    @Modifying
    @Query("update MyModel m set m.field1 = :field1, m.field3 = :field3 where m.field2 = :field2")
    int updateByField2(@Param("field2") String field2, @Param("field1") String field1, @Param("field3") Integer field3);

    // 原生SQL方式（适用于复杂更新场景）
    @Modifying
    @Query(value = "update my_model set field1 = :field1, field3 = :field3 where field2 = :field2", nativeQuery = true)
    int updateByField2Native(@Param("field2") String field2, @Param("field1") String field1, @Param("field3") Integer field3);
}

使用时直接调用该方法即可，返回值为受影响的行数：

• 返回1：更新成功
• 返回0：无匹配field2的记录

注意事项

• 使用@Modifying注解时，需配合@Transactional注解（若在事务外调用）
• 这种方式不会触发JPA的实体生命周期回调（如@PreUpdate），也不会更新乐观锁版本号，需根据业务场景选择

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