编程式事务管理的核心是开发者用代码精确控制事务的开始、提交、回滚及保存点，适用于复杂业务场景。它通过transactiontemplate或底层api在service层实现，需避免new实例、异常捕获后未设回滚、非spring数据源等常见错误。

编程式事务管理在业务层的核心，是把“事务什么时候开始、什么时候提交、什么时候回滚、甚至中间要不要保存点或嵌套分支”，完全交由开发者用代码决定。它不是靠注解自动包裹整个方法，而是深入到业务逻辑内部，按需控制事务生命周期。

为什么业务层需要编程式事务

当业务规则复杂到无法用一个方法粒度统一处理时，声明式事务（如 @Transactional）就力不从心了。典型场景包括：

• 支付回调中，先记录日志并提交（确保可追溯），再调用第三方接口；失败时不影响已存日志
• 批量导入数据时，某几条出错只回滚那几条，其余继续提交（配合 savepoint）
• 条件分支下事务行为不同：A路径需强一致性提交，B路径允许部分失败后走补偿流程
• 需要在同一个 service 方法里开启多个独立事务（例如：更新本地状态 + 发送 MQ 消息并保证消息事务性）

关键组件与基础流程

Spring 提供两套编程式事务入口，推荐优先使用 TransactionTemplate，它封装了 PlatformTransactionManager 的模板逻辑，更简洁安全：

• TransactionTemplate：基于回调模式，自动处理 commit/rollback，异常时默认回滚，支持自定义传播行为和隔离级别
• PlatformTransactionManager + TransactionDefinition + TransactionStatus：底层 API，适合需要完全掌控事务状态（如手动 setRollbackOnly、创建 savepoint、判断是否已有事务等）的场景

无论哪种方式，事务控制必须发生在 service 层（事务边界层），不能放在 controller 或 dao 层——controller 关注交互，dao 只负责单次操作，只有 service 才掌握完整业务语义。

Alibabacloud Sdk Client Initialization For Java

在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载

典型实现步骤（以 TransactionTemplate 为例）

假设一个订单审核通过后，需同步更新订单状态、扣减库存、生成发货单，但库存不足时只回滚扣减动作，保留审核记录：

• 注入 TransactionTemplate 实例（通常通过 @Autowired）
• 在业务方法内调用 execute()，传入 TransactionCallback
• 在回调中编写核心逻辑；若需局部回滚，可用 status.createSavepoint() + status.rollbackToSavepoint()
• 不抛出异常即默认提交；主动调用 status.setRollbackOnly() 可强制回滚

示例片段：

transactionTemplate.execute(status -> {
  orderService.updateStatus(orderId, APPROVED); // 审核记录，必须落库
  Savepoint sp = status.createSavepoint();
  try {
    inventoryService.deduct(stockCode, quantity);
  } catch (InsufficientStockException e) {
    status.rollbackToSavepoint(sp); // 仅回滚库存操作
    compensateWithBackOrder(orderId); // 走补单逻辑
  }
  shippingService.generateBill(orderId);
  return null;
});

注意事项与避坑点

编程式事务看似灵活，但容易因细节疏忽导致失效：

• TransactionTemplate 必须使用 Spring 管理的 Bean 实例，不可 new 出来——否则无法接入事务上下文
• 回调内发生的 RuntimeException 默认触发回滚；若捕获了异常又没调用 setRollbackOnly，事务会照常提交
• 同一线程内多次调用 execute() 默认复用当前事务（取决于 propagation 设置），如需新事务，应显式配置 REQUIRES_NEW
• 数据库连接必须由 Spring 的 DataSource 提供（如 HikariCP 配合 DataSourceTransactionManager），直连 JDBC Connection 不受 Spring 事务管理
• 事务内避免调用本类未代理的 private 方法——它们绕过 AOP 和事务拦截器

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南