Java 后端 / 知识点

Spring 事务传播与隔离级别速查手册

日常操作

使用 @Transactional 为业务方法建立默认事务边界,适合单个服务方法内的一组数据库写操作;通常优先放在 Service 层公共方法,而不是 Controller 或私有方法。

声明默认事务边界

需要保证一次业务操作中的多次数据库修改同时成功或回滚时,应在 Spring 管理的 Service 方法上使用 @Transactional。默认传播行为为 REQUIRED,通常将事务边界放在能够表达完整业务动作的公共业务方法上。

基本用法

片段示例:依赖 Spring Boot、Spring Data JPA,以及已定义的 OrderRepository、InventoryRepository 和 Order 类型。示例使用显式构造器,避免引入额外 Lombok 依赖。

java
import org.springframework.stereotype.Service;
import org.springframework.transaction.annotation.Transactional;

@Service
public class OrderService {
    private final OrderRepository orderRepository;
    private final InventoryRepository inventoryRepository;

    public OrderService(OrderRepository orderRepository,
                        InventoryRepository inventoryRepository) {
        this.orderRepository = orderRepository;
        this.inventoryRepository = inventoryRepository;
    }

    @Transactional
    public void createOrder(Long productId) {
        inventoryRepository.decreaseStock(productId);
        orderRepository.save(new Order(productId));
    }
}

预期输出

text
方法正常返回:库存扣减与订单写入在同一事务中提交
运行时异常向外抛出:未提交的数据库修改一起回滚

回滚规则

默认情况下,未捕获并传播到事务拦截器的 RuntimeException 和 Error 会触发回滚,普通受检异常默认不会。业务需要受检异常回滚时显式配置:

java
@Transactional(rollbackFor = Exception.class)
public void importOrder() throws Exception {
    // 业务写操作后抛出受检异常时触发回滚
    throw new Exception("import failed");
}

预期输出

text
Exception: import failed
事务结果:ROLLBACK

风险与边界

事务中不要长期执行 HTTP、RPC、文件处理或人工等待,否则会延长数据库连接和锁持有时间。只把需要数据库原子性的操作放入事务。

排障清单

事务未按预期工作时,依次检查调用是否经过 Spring 代理、异常是否被捕获、异常类型是否满足回滚规则,以及数据库操作是否由同一个事务管理器控制。

边界控制

排障

目录与阅读设置

记录一个想法

Spring 事务传播与隔离级别速查手册

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通