Spring Boot JPA事务实现：事务内临时违反复合唯一约束

数据库存在复合唯一约束，期望事务内违反该约束时，仅在调用commit后才触发约束校验。已在Spring的@Service类及方法上添加@Transactional注解，但调用userRepository.save(userEntity)时立即抛出如下异常：

java.sql.SQLIntegrityConstraintViolationException: (conn=380) Duplicate entry ...'

控制器代码：

@PostMapping("/save")
@Transactional
fun createUser(
    @RequestHeader("token", required = true) subject: String,
): ResponseEntity<*> {
    val id = extractId(subject)
    return userService.save(id)
}

服务类代码：

@Transactional
fun save(id: String): ResponseEntity<*> {
 val validatedUser =  getValidatedUser(id)
 return ResponseEntity<User>(validatedUser, HttpStatus.CREATED)
}

@Transactional
fun getValidatedUser(id: String): User? {
   var list = listOf(User(id))
   val newUser = //some logic to generate user
   userRepository.saveAll(list.plus(newUser)) // <--- 错误发生处
}

解决方案 #

核心原因 #

JPA默认的刷新模式（FlushMode）为AUTO，会在执行查询、事务提交前自动将持久化上下文的变更同步到数据库，导致save()/saveAll()方法调用时立刻执行SQL语句，违反约束的操作会被数据库即时拦截抛出异常。

具体解决措施 #

1. 修改JPA刷新模式为提交时触发
   通过EntityManager手动设置刷新模式为COMMIT，让所有SQL操作延迟到事务提交时才执行：

   @PersistenceContext
   private lateinit var entityManager: EntityManager
   
   @Transactional
   fun getValidatedUser(id: String): User? {
       // 仅在事务提交时才刷新持久化上下文到数据库
       entityManager.setFlushMode(FlushModeType.COMMIT)
       
       var list = listOf(User(id))
       val newUser = // 生成用户的业务逻辑
       // 此时saveAll仅将实体加入上下文，不执行SQL
       userRepository.saveAll(list.plus(newUser))
       
       // 可继续执行其他业务逻辑，直到事务提交才触发约束校验
       return newUser
   }
   

2. 清理嵌套事务配置
   内层方法getValidatedUser上的@Transactional注解可移除，因为外层save方法的事务已经覆盖该方法；若保留需确保事务传播行为为默认的REQUIRED，避免因REQUIRES_NEW导致内层事务提前提交触发校验。

3. 适配数据库约束校验时机
   部分数据库（如MySQL InnoDB）不支持延迟唯一约束校验，即使JPA延迟刷新，执行SQL时仍会即时检查。此时可：

   • 先在业务层手动查询校验唯一性，提前规避重复；
   • 若使用支持延迟约束的数据库（如PostgreSQL），可将复合唯一约束设置为延迟校验：

     ALTER TABLE user_table 
     ADD CONSTRAINT unique_user_key UNIQUE (col1, col2) 
     DEFERRABLE INITIALLY DEFERRED;
     

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