4、编程式事务管理：TransactionTemplate使用、PlatformTransactionManager手动控制、与声明式对比

在Spring生态中，事务管理主要分为声明式（@Transactional）和编程式两种范式。当API边界需要细粒度控制事务范围、处理嵌套回滚或动态决定提交/回滚时，编程式事务管理提供了声明式无法比拟的灵活性。本节将深入剖析两种编程式实现方式，并与声明式进行系统性对比。

4.1 TransactionTemplate：模板方法模式的事务封装

TransactionTemplate 是Spring提供的最简洁的编程式事务工具。它遵循模板方法模式，将事务的开启、提交、回滚等样板代码封装在内部，开发者只需关注业务逻辑。

4.1.1 标准使用模式

@Service
public class OrderService {

    private final TransactionTemplate transactionTemplate;

    // 构造器注入
    public OrderService(PlatformTransactionManager transactionManager) {
        this.transactionTemplate = new TransactionTemplate(transactionManager);
        // 可选：配置事务属性
        this.transactionTemplate.setPropagationBehavior(TransactionDefinition.PROPAGATION_REQUIRED);
        this.transactionTemplate.setIsolationLevel(TransactionDefinition.ISOLATION_READ_COMMITTED);
    }

    public Order createOrder(OrderRequest request) {
        return transactionTemplate.execute(status -> {
            // 1. 业务操作
            Order order = saveOrder(request);
            // 2. 库存扣减（可能抛出异常）
            inventoryService.deductStock(request.getProductId(), request.getQuantity());
            // 3. 发送事件（事务成功后执行）
            eventPublisher.publishEvent(new OrderCreatedEvent(order.getId()));
            return order;
            // 无需显式提交/回滚，模板自动处理
        });
    }
}

4.1.2 回滚控制策略

TransactionTemplate 默认在运行时异常（RuntimeException）和Error时回滚，受检异常（Checked Exception）不会触发回滚。如需自定义回滚规则，可通过 TransactionCallbackWithoutResult 或手动调用 status.setRollbackOnly()。

transactionTemplate.execute(status -> {
    try {
        // 业务逻辑
        processBusiness();
    } catch (BusinessException e) {
        // 手动标记回滚
        status.setRollbackOnly();
        // 记录错误或抛出新异常
        throw new RuntimeException("业务异常，事务回滚", e);
    }
    return null;
});

4.2 PlatformTransactionManager：完全手动的事务控制

当需要跨多个数据源、控制事务挂起/恢复、或实现复杂的事务传播行为时，直接使用 PlatformTransactionManager 提供了最大的控制权。

4.2.1 手动控制三步骤

4.2.2 完整手动控制示例

@Service
public class PaymentService {

    private final PlatformTransactionManager transactionManager;

    public PaymentService(PlatformTransactionManager transactionManager) {
        this.transactionManager = transactionManager;
    }

    public PaymentResult processPayment(PaymentRequest request) {
        // 定义事务属性
        DefaultTransactionDefinition def = new DefaultTransactionDefinition();
        def.setPropagationBehavior(TransactionDefinition.PROPAGATION_REQUIRED);
        def.setIsolationLevel(TransactionDefinition.ISOLATION_REPEATABLE_READ);
        def.setTimeout(30); // 30秒超时

        TransactionStatus status = transactionManager.getTransaction(def);
        try {
            // 1. 扣款
            accountService.debit(request.getFromAccount(), request.getAmount());
            // 2. 入账
            accountService.credit(request.getToAccount(), request.getAmount());
            // 3. 记录流水
            paymentRecordService.record(request);

            // 业务成功，提交事务
            transactionManager.commit(status);
            return PaymentResult.success();
        } catch (Exception e) {
            // 业务失败，回滚事务
            transactionManager.rollback(status);
            return PaymentResult.failure(e.getMessage());
        }
    }
}

4.3 编程式 vs 声明式：全面对比

选择哪种事务管理方式，取决于API边界的复杂度、团队规范以及性能要求。下表从多个维度进行对比：

4.4 编程式事务的架构决策流程

在API开发阶段，选择事务管理方式应遵循以下决策树：

4.5 编程式事务的常见陷阱与最佳实践

• 陷阱1：事务管理器与数据源不匹配 —— 确保注入的 PlatformTransactionManager 与目标数据源对应，多数据源时使用 @Qualifier 明确指定。
• 陷阱2：TransactionTemplate 内嵌调用自身方法 —— 模板内部的方法调用不会触发AOP代理，如需事务传播，应通过注入的Service代理调用。
• 陷阱3：手动事务中捕获异常后未回滚 —— 在 PlatformTransactionManager 的 try-catch 中，每个异常分支都必须明确调用 rollback()。
• 陷阱4：事务超时设置不当 —— 长时间运行的事务会持有数据库连接，导致连接池耗尽。建议设置合理的超时时间（默认-1表示不超时）。