JPA @Version乐观锁失效问题求助（Oracle 21C）

1. 检查实体类的@Version注解配置 #

确保实体类的version字段正确标注了@Version注解，且字段类型符合要求（通常为Integer、Long或Timestamp）。示例：

@Entity
public class YourEntity {
    // 其他字段
    @Version
    private Integer version;
    
    // getter、setter
}

如果注解缺失或类型错误，乐观锁机制根本不会触发。

2. 排查更新逻辑的实体处理方式 #

你当前的更新流程大概率是先从数据库加载实体，再将传入的DTO字段（包括固定version）覆盖到加载的实体上，这会导致JPA实际使用数据库加载的最新version值执行更新，而非你传入的固定值。

正确处理方式：

• 直接基于传入的DTO构建实体（或映射时保留传入的version值），调用EntityManager.merge()或Spring Data JPA的save()方法，前提是该实体未被当前持久化上下文管理。
• 或者手动用JPQL/原生SQL执行更新，在WHERE条件中显式加入version对比：

@Modifying
@Query("UPDATE YourEntity e SET e.field = :value, e.updateDateTime = :date WHERE e.id = :id AND e.version = :version")
int updateEntity(@Param("id") Long id, @Param("value") String value, @Param("date") LocalDateTime date, @Param("version") Integer version);

这种方式会直接在SQL层面校验version，返回更新行数，若返回0说明version不匹配，可手动抛出OptimisticLockException。

3. 修正Spring Data JPA的save()行为 #

调用repository.save(entity)时，如果实体已被持久化上下文（比如之前通过findById加载）管理，JPA会使用上下文里的实体状态（含加载时的version）执行更新，忽略你手动设置的version值。

解决方法：

• 更新前不要从数据库加载实体，直接构造包含传入id和version的实体，设置其他更新字段后调用save()。
• 或者调用EntityManager.detach()将已加载的实体从上下文分离，再设置传入的version后执行更新。

4. 验证数据库层面的更新语句 #

开启JPA的SQL日志（比如在application.yml中设置spring.jpa.show-sql: true），观察更新语句是否包含WHERE version = ?的条件。正常的乐观锁更新SQL应该是：

UPDATE your_entity SET field = ?, update_date_time = ?, version = ? WHERE id = ? AND version = ?

如果SQL里没有AND version = ?，说明乐观锁机制未触发，回到前面步骤检查注解和实体管理逻辑。

5. 检查映射器（Mapper）的规则 #

如果使用MapStruct或其他映射工具，确认映射规则是否会覆盖version值。确保映射器保留传入的version值，不要给version字段设置默认值或被其他逻辑覆盖。

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