Spring 事务总踩坑？一文吃透事务管理 + 数据访问底层源码与生产最佳实践

文章目录

• • 一、概述
  • 二、Spring 事务管理体系总览
  • • 2.1 模块定位与技术栈
    • 2.2 核心架构分层
    • 2.3 设计模式与架构原则
    • • 模板方法模式（Template Method）
      • 策略模式（Strategy）
      • 代理模式（Proxy）
      • 观察者模式（Observer）
      • 适配器模式（Adapter）
  • 三、核心接口体系：PlatformTransactionManager 与事务定义
  • • 3.1 PlatformTransactionManager 接口
    • 3.2 TransactionDefinition 事务定义
    • 3.3 TransactionStatus 事务状态
    • 3.4 AbstractPlatformTransactionManager 抽象基类
    • • 3.4.1 传播行为处理
      • 3.4.2 同步激活策略
      • 3.4.3 提交/回滚流程
  • 四、声明式事务管理：@Transactional 与 AOP 拦截机制
  • • 4.1 注解驱动配置 @EnableTransactionManagement
    • 4.2 AOP 代理机制与代理选择策略
    • • 代理创建流程
      • 关键注意事项
    • 4.3 TransactionInterceptor 事务拦截器工作流
    • 4.4 TransactionAttributeSource 事务属性源
    • 4.5 XML 命名空间配置方式
  • 五、编程式事务管理：TransactionTemplate 详解
  • • 5.1 TransactionTemplate 核心能力
    • 5.2 execute() 执行流程与异常处理
    • 5.3 编程式 vs 声明式对比
    • 5.4 事务回调机制
    • 5.5 事务管理器选择与配置
  • 六、事务属性详解
  • • 6.1 传播行为（Propagation Behavior）完整解析
    • • 各传播行为的详细语义图示
    • 6.2 隔离级别（Isolation Level）
    • 6.3 超时与只读配置
    • 6.4 回滚规则
  • 七、异常处理机制与数据访问异常层次结构
  • • 7.1 DataAccessException 层次结构
    • 7.2 常见数据访问异常类型
    • 7.3 PersistenceExceptionTranslator 异常翻译器
    • 7.4 异常转换规则
    • 7.5 事务异常层次：TransactionException 及其子类
  • 八、响应式事务管理
  • • 8.1 ReactiveTransactionManager 接口
    • 8.2 TransactionalOperator 操作符
    • 8.3 事务上下文管理
    • 8.4 响应式同步机制
  • 九、分布式事务管理（JTA/XA）
  • • 9.1 JTA 集成概述
    • 9.2 JTA 配置详解
    • • 基础配置（自动 JNDI 查找）
      • 手动注入 JTA 组件
      • 常用配置选项
    • 9.3 XA 事务管理
    • 9.4 JNDI 查找机制
  • 十、事务事件监听机制
  • • 10.1 @TransactionalEventListener 注解
    • 10.2 事件发布与订阅
    • 10.3 事务事件阶段类型
    • 10.4 应用监听器集成
  • 十一、性能优化与监控
  • • 11.1 TransactionSynchronizationManager 性能考量
    • 11.2 事务传播与同步激活策略
    • 11.3 提交/回滚路径优化
    • 11.4 可观察性与诊断策略
  • 十二、故障排除指南
  • • 12.1 常见事务异常及解决方案
    • • 问题 1：@Transactional 不生效
      • 问题 2：事务超时（TransactionTimedOutException）
      • 问题 3：意外回滚（UnexpectedRollbackException）
      • 问题 4：死锁（DeadlockLoserDataAccessException）
      • 问题 5：乐观锁失败（OptimisticLockingFailureException）
    • 12.2 性能问题排查
    • 12.3 调试工具与技巧
    • 12.4 日志与监控配置
  • 十三、测试策略
  • • 13.1 单元测试
    • 13.2 集成测试
    • 13.3 响应式测试
  • 十四、编码规范与最佳实践总结
  • • 14.1 核心编码规范
    • 14.2 最佳实践清单
  • 十五、常见问题解答（FAQ）
  • • Q1：@Transactional 注解在 private 方法上为什么不生效？
    • Q2：PROPAGATION_REQUIRES_NEW 和 PROPAGATION_NESTED 有什么区别？
    • Q3：什么时候应该使用编程式事务而不是声明式事务？
    • Q4：如何处理分布式事务的一致性问题？
    • Q5：TransactionSynchronizationManager 的 ThreadLocal 会导致内存泄漏吗？
    • Q6：如何在测试中验证事务行为？
  • 十六、总结与参考资料
  • • 核心要点回顾