Spring Data JPA@Query修改查询为何不自动更新@Version字段？

原因分析 #

• 当使用Spring Data JPA的内置方法（如save()）时，框架会完整管理实体的生命周期：先将实体加载到持久化上下文，修改字段后，事务提交阶段JPA会自动识别@Version注解，完成字段递增并更新数据库，这是乐观锁机制在实体层面的标准实现。
• 而@Modifying + @Query的自定义修改查询属于直接数据库操作，它会跳过持久化上下文，直接生成SQL语句在数据库端执行。由于JPA的乐观锁依赖于持久化上下文对实体状态的跟踪，这种绕过上下文的操作自然无法触发version字段的自动递增逻辑。

解决方案 #

要让自定义更新方法自动维护version字段，推荐以下两种方式：

1. 基于实体生命周期的标准操作（推荐） #

先通过查询方法加载实体，修改字段后调用save()，框架会自动处理version的递增：

public interface FooRepository extends JpaRepository<Foo, Long> {

    default void updateFoo(Long id) {
        Foo foo = findById(id).orElseThrow(() -> new IllegalArgumentException("Foo不存在"));
        foo.setBar("hello");
        save(foo);
    }
}

这种方式完全遵循JPA规范，不仅自动维护version，还能在版本冲突时抛出OptimisticLockingFailureException，保证乐观锁的有效性。

2. 在@Query中显式维护version（批量场景可选） #

如果必须使用批量更新查询，可以在SQL中显式递增version字段，同时加入版本条件实现乐观锁：

public interface FooRepository extends JpaRepository<Foo, Long> {

    @Modifying
    @Query(value = "UPDATE Foo foo SET foo.bar = 'hello', foo.version = foo.version + 1 WHERE foo.id = :id AND foo.version = :version")
    int updateFoo(@Param("id") Long id, @Param("version") Long version);
}

调用时需要传入目标实体的当前version值，方法返回值为实际更新的行数。如果返回0，说明版本已过期，需要处理乐观锁冲突。

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