TransactionTemplate 与@Transactional 注解的功能及方法详解

---

TransactionTemplate 功能及方法详解

---

1. TransactionTemplate 功能

TransactionTemplate 是 Spring 提供的 编程式事务管理工具，通过代码显式控制事务的开启、提交和回滚，适用于需要动态或复杂事务逻辑的场景。

---

2. 核心方法及使用

(1) execute(TransactionCallback action)

• 功能：执行包含事务的代码块，支持返回值。
• 代码示例：

  User user = transactionTemplate.execute(status -> {
      try {
          User newUser = userDao.save(user); // 事务操作
          return newUser;
      } catch (DataAccessException e) {
          status.setRollbackOnly(); // 标记回滚
          throw new ServiceException("保存用户失败", e);
      }
  });
  

(2) executeWithoutResult(Consumer action)

• 功能：执行无返回值的事务操作。
• 代码示例：

  transactionTemplate.executeWithoutResult(status -> {
      userDao.updateBalance(userId, amount); // 扣减余额
      orderDao.createOrder(order);           // 创建订单
  });
  

(3) 事务属性配置

• 传播行为：setPropagationBehavior()

  // 新建独立事务（即使当前存在事务）
  transactionTemplate.setPropagationBehavior(TransactionDefinition.PROPAGATION_REQUIRES_NEW);
  

• 隔离级别：setIsolationLevel()

  // 避免脏读（默认级别为 ISOLATION_DEFAULT，依赖数据库配置）
  transactionTemplate.setIsolationLevel(TransactionDefinition.ISOLATION_READ_COMMITTED);
  

• 超时时间：setTimeout()

  transactionTemplate.setTimeout(30); // 单位：秒
  

---

3. @Transactional 注解详解

---

(1) 功能

@Transactional 是 Spring 提供的 声明式事务管理 注解，通过 AOP 代理自动管理事务，简化事务配置，适合大多数场景。

---

(2) 核心属性

属性	说明
propagation	事务传播行为（默认 PROPAGATION_REQUIRED，支持当前事务或新建事务）
isolation	隔离级别（默认 ISOLATION_DEFAULT，使用数据库默认级别）
timeout	超时时间（单位：秒）
readOnly	是否只读事务（默认 false，优化查询性能）
rollbackFor	指定触发回滚的异常类型（默认回滚 RuntimeException 和 Error）
noRollbackFor	指定不触发回滚的异常类型

---

(3) 使用示例

基本用法

@Service
public class OrderService {
    @Autowired
    private OrderDao orderDao;
    @Autowired
    private InventoryDao inventoryDao;

    @Transactional
    public void createOrder(Order order) {
        orderDao.save(order);          // 保存订单
        inventoryDao.deductStock(order.getProductId(), order.getQuantity()); // 扣减库存
        // 若发生异常（如库存不足），事务自动回滚
    }
}

自定义回滚规则

@Transactional(rollbackFor = {BusinessException.class, SQLException.class})
public void transferMoney(Long fromId, Long toId, BigDecimal amount) {
    accountDao.deductBalance(fromId, amount); // 转出
    accountDao.addBalance(toId, amount);      // 转入
    if (amount.compareTo(BigDecimal.ZERO) < 0) {
        throw new BusinessException("金额不能为负"); // 触发回滚
    }
}

传播行为控制

@Transactional(propagation = Propagation.REQUIRES_NEW)
public void auditLog(String action) {
    logDao.saveAuditLog(action); // 独立事务记录日志，即使外层事务回滚，日志仍保留
}

只读事务优化

@Transactional(readOnly = true)
public BigDecimal getAccountBalance(Long userId) {
    return accountDao.findBalance(userId); // 只读事务，提升查询性能
}

---

4. TransactionTemplate vs @Transactional

特性	TransactionTemplate	@Transactional
事务控制方式	编程式（显式代码控制）	声明式（AOP 代理自动管理）
代码侵入性	高（需手动包裹代码块）	低（通过注解配置）
灵活性	高（可动态控制事务逻辑）	中（需提前配置属性）
适用场景	复杂事务（如条件事务、嵌套事务）	简单事务（如单方法原子操作）
异常处理	需手动标记回滚（status.setRollbackOnly()）	自动根据异常类型回滚

---

5. 实战场景分析

(1) 场景 1：跨多服务调用的事务

• 需求：订单创建后调用第三方支付服务，若支付失败需回滚订单。
• 方案：使用 TransactionTemplate 显式控制事务边界。

  public void createOrderWithPayment(Order order, PaymentRequest paymentRequest) {
      transactionTemplate.execute(status -> {
          orderDao.save(order); // 事务操作1：保存订单
          boolean paymentSuccess = paymentService.process(paymentRequest); // 调用外部支付
          if (!paymentSuccess) {
              status.setRollbackOnly(); // 手动回滚
              throw new PaymentException("支付失败");
          }
          return order;
      });
  }
  

(2) 场景 2：嵌套事务

• 需求：主业务逻辑需要记录审计日志，但日志记录失败不应影响主事务。
• 方案：使用 @Transactional(propagation = REQUIRES_NEW)。

  @Transactional
  public void processOrder(Order order) {
      orderService.save(order);    // 主事务
      auditService.auditLog("订单创建"); // 独立事务
  }
  
  @Service
  public class AuditService {
      @Transactional(propagation = Propagation.REQUIRES_NEW)
      public void auditLog(String action) {
          logDao.save(action); // 独立事务
      }
  }
  

(3) 场景 3：只读查询优化

• 需求：高并发下查询用户余额，需提升性能。
• 方案：使用 @Transactional(readOnly = true)。

  @Transactional(readOnly = true)
  public BigDecimal getBalance(Long userId) {
      return accountDao.findBalance(userId); // 只读事务，数据库可能启用优化（如避免锁）
  }
  

---

6. 常见问题及解决

(1) @Transactional 失效场景

• 自调用问题：同类方法内部调用 @Transactional 方法，不经过代理。

  public void outerMethod() {
      innerMethod(); // 自调用，事务失效
  }
  
  @Transactional
  public void innerMethod() {
      // 事务操作
  }
  

  解决：通过注入自身代理对象调用：

  @Autowired
  private OrderService selfProxy; // 通过 ApplicationContext 获取代理对象
  
  public void outerMethod() {
      selfProxy.innerMethod(); // 正确触发事务
  }
  

(2) 异常未触发回滚

• 原因：默认仅回滚 RuntimeException 和 Error，检查异常（如 IOException）需手动配置。

  @Transactional(rollbackFor = IOException.class)
  public void importData() throws IOException {
      // 抛出 IOException 时会回滚
  }
  

(3) 事务传播行为冲突

• 示例：内层方法使用 Propagation.MANDATORY（要求存在事务），但外层未开启事务。

  @Transactional(propagation = Propagation.MANDATORY)
  public void innerMethod() {} // 若外层无事务，抛出异常
  

---

7. 总结

• TransactionTemplate：

  • 适用场景：动态事务、嵌套事务、跨多资源操作。
  • 优点：灵活控制事务逻辑。
  • 缺点：代码侵入性高，需手动处理异常。

• @Transactional：

  • 适用场景：单方法原子操作、简单事务。
  • 优点：代码简洁，无侵入性。
  • 缺点：配置需谨慎（如传播行为、异常回滚规则）。

选择建议：

• 优先使用 @Transactional，代码更简洁。
• 复杂事务逻辑（如条件事务、手动回滚）使用 TransactionTemplate。