spring boot 全局异常处理捕获锁等待异常的核心做法是:在 @controlleradvice 中注册针对 pessimisticlockingfailureexception 或 optimisticlockingfailureexception 的 @exceptionhandler。当数据库事务因并发冲突抛出这些异常时,spring 会自动将其拦截并交由对应方法处理,从而返回自定义的错误响应。

悲观锁冲突时如何返回特定错误码
当使用 JPA 的 @Lock(LockModeType.PESSIMISTIC_WRITE) 或原生 SQL 的 FOR UPDATE 时,若发生锁等待超时或死锁,底层会抛出 PessimisticLockingFailureException。在全局异常处理器中捕获该异常后,可以提取具体的 SQL 状态码(如 40001)来区分不同的锁冲突场景,并返回统一的 JSON 结构。

package com.example.demo;import org.springframework.boot.SpringApplication;import org.springframework.boot.autoconfigure.SpringBootApplication;
@SpringBootApplicationpublic class DemoApplication { public static void main(String[] args) { SpringApplication.run(DemoApplication.class, args); }}package com.example.demo.controller;import org.springframework.data.jpa.repository.JpaRepository;import org.springframework.data.jpa.repository.Lock;import org.springframework.stereotype.Repository;import java.util.Optional;import javax.persistence.LockModeType;import com.example.demo.entity.Order;@Repositorypublic interface OrderRepository extends JpaRepository<Order, Long> { @Lock(LockModeType.PESSIMISTIC_WRITE) Optional<Order> findByIdForUpdate(Long id);}package com.example.demo.service;import org.springframework.beans.factory.annotation.Autowired;import org.springframework.stereotype.Service;import org.springframework.transaction.annotation.Transactional;import com.example.demo.repository.OrderRepository;import com.example.demo.entity.Order;@Servicepublic class OrderService { @Autowired private OrderRepository orderRepository; @Transactional public Order processOrder(Long orderId) { Order order = orderRepository.findByIdForUpdate(orderId).orElseThrow(); if (order.getStatus() == 0) { order.setStatus(1); } return order; }}package com.example.demo.exception;import org.springframework.http.HttpStatus;import org.springframework.http.ResponseEntity;import org.springframework.orm.ObjectOptimisticLockingFailureException;import org.springframework.orm.hibernate5.PessimisticLockingFailureException;import org.springframework.web.bind.annotation.ExceptionHandler;import org.springframework.web.bind.annotation.RestControllerAdvice;import java.util.HashMap;import java.util.Map;@RestControllerAdvicepublic class GlobalExceptionHandler { @ExceptionHandler(PessimisticLockingFailureException.class) public ResponseEntity<Map<String, Object>> handlePessimisticLock(PessimisticLockingFailureException ex) { Map<String, Object> body = new HashMap<>(); body.put("error", "LOCK_TIMEOUT"); body.put("message", "资源正被其他事务占用"); return ResponseEntity.status(HttpStatus.CONFLICT).body(body); } @ExceptionHandler(ObjectOptimisticLockingFailureException.class) public ResponseEntity<Map<String, Object>> handleOptimisticLock(ObjectOptimisticLockingFailureException ex) { Map<String, Object> body = new HashMap<>(); body.put("error", "VERSION_MISMATCH"); body.put("message", "数据版本已更新"); return ResponseEntity.status(HttpStatus.CONFLICT).body(body); }}预期结果:当两个线程同时调用 processOrder 且第一个线程未提交时,第二个线程将收到 HTTP 409 Conflict 响应,Body 为 {"error":"LOCK_TIMEOUT","message":"资源正被其他事务占用"}。
乐观锁冲突时如何触发重试机制
当实体类包含 @Version 字段时,JPA 会在更新时检查版本号。如果检测到版本不一致,会抛出 ObjectOptimisticLockingFailureException。为了提升用户体验,可以在异常处理器中记录日志,或者结合 Spring Retry 等库自动触发少量次数的重试,而不是直接报错。

package com.example.demo.entity;import org.springframework.data.annotation.Version;import javax.persistence.Entity;import javax.persistence.GeneratedValue;import javax.persistence.GenerationType;import javax.persistence.Id;@Entitypublic class Order { @Id @GeneratedValue(strategy = GenerationType.IDENTITY) private Long id; private int status; @Version private int version; // getters and setters}预期结果:当用户尝试更新一个已被修改的订单时,系统抛出 ObjectOptimisticLockingFailureException,全局处理器捕获后返回 {"error":"VERSION_MISMATCH","message":"数据版本已更新"}。若集成重试逻辑,程序将在短暂休眠后重新加载最新数据再次尝试更新。
基于输入参数 orderId 为空时的具体行为
当传入的 orderId 为 null 或不存在于数据库中时,findByIdForUpdate 将返回空的 Optional。此时 orElseThrow() 会抛出 NoSuchElementException。由于该异常并非锁相关异常,全局异常处理器中的锁异常处理方法不会生效,而是由 Spring MVC 默认的异常处理机制接管,通常返回 HTTP 404 Not Found 或 500 Internal Server Error,具体取决于是否配置了通用的 @ExceptionHandler(NoSuchElementException.class)。


















