3、声明式事务管理：@Transactional注解详解、传播行为(Propagation)、隔离级别(Isolation)

在Spring框架中，声明式事务管理通过@Transactional注解极大地简化了事务边界的定义。开发者只需在需要事务支持的方法或类上添加该注解，即可将事务管理逻辑与业务代码解耦。本节将深入剖析@Transactional的核心属性，重点讲解传播行为与隔离级别的选择策略，帮助你在API开发中精准控制事务边界。

3.1 @Transactional注解核心属性

@Transactional注解提供了多个配置属性，用于精细控制事务的行为。下表列出了最常用的属性及其说明：

3.2 传播行为（Propagation）详解

传播行为定义了当被@Transactional修饰的方法被另一个事务方法调用时，事务该如何扩散。Spring定义了7种传播行为，其中REQUIRED、REQUIRES_NEW和NESTED是API开发中最常用的三种。

3.2.1 核心传播行为对比

3.2.2 传播行为决策流程

下面的SVG图展示了当调用一个带有@Transactional注解的方法时，Spring如何根据传播行为决定事务的创建与挂起策略：

3.3 隔离级别（Isolation）详解

隔离级别定义了事务之间数据可见性的程度。较高的隔离级别可以防止并发问题（脏读、不可重复读、幻读），但会降低数据库的并发性能。Spring支持5种隔离级别：

3.3.1 隔离级别与并发问题对照

3.3.2 隔离级别选择策略

下面的SVG图展示了在API事务中如何根据业务场景选择合适的隔离级别：

3.4 实战代码示例

以下代码展示了如何在API服务中组合使用传播行为与隔离级别：

@Service
public class OrderService {

    @Autowired
    private OrderRepository orderRepository;

    @Autowired
    private AuditLogService auditLogService;

    /**
     * 创建订单：主事务使用REPEATABLE_READ防止并发下单时的幻读
     */
    @Transactional(
        propagation = Propagation.REQUIRED,
        isolation = Isolation.REPEATABLE_READ,
        rollbackFor = Exception.class,
        timeout = 30
    )
    public Order createOrder(OrderCreateRequest request) {
        // 1. 校验库存（当前事务内）
        validateStock(request.getProductId(), request.getQuantity());

        // 2. 创建订单
        Order order = new Order();
        order.setProductId(request.getProductId());
        order.setQuantity(request.getQuantity());
        order.setStatus(OrderStatus.CREATED);
        orderRepository.save(order);

        // 3. 记录审计日志（独立事务，不受主事务回滚影响）
        auditLogService.logOrderCreation(order.getId(), "订单创建成功");

        return order;
    }
}

@Service
public class AuditLogService {

    /**
     * 审计日志使用REQUIRES_NEW，确保日志独立提交
     * 即使主事务回滚，日志也能保留
     */
    @Transactional(
        propagation = Propagation.REQUIRES_NEW,
        isolation = Isolation.READ_COMMITTED,
        rollbackFor = Exception.class
    )
    public void logOrderCreation(Long orderId, String message) {
        AuditLog log = new AuditLog();
        log.setOrderId(orderId);
        log.setMessage(message);
        log.setTimestamp(LocalDateTime.now());
        auditLogRepository.save(log);
    }
}

3.5 常见错误与避坑指南

• 自调用失效：同一个类中方法A调用方法B，方法B上的@Transactional不会生效。解决方案：将方法B拆分到另一个Service类，或通过AopContext.currentProxy()获取代理对象。
• 传播行为误用：在批量处理中错误使用REQUIRES_NEW，导致大量短连接耗尽数据库连接池。应优先考虑NESTED或分批提交。
• 隔离级别过高：在非必要场景使用SERIALIZABLE，导致API响应时间急剧上升。建议从READ_COMMITTED开始，根据压测结果逐步提升。
• 忽略回滚策略：默认只回滚RuntimeException和Error，自定义受检异常不会触发回滚。务必显式设置rollbackFor。