SpringBoot @Transactional 注解未生效

蔚落 2023-10-08 10:07 14阅读 0赞

#### 文章目录 ####

*  1. SpringBoot 中使用事务的正确方式
 *  2. @Transactional 注解未生效的原因
 *   *   *  2.1 数据库引擎不支持事务
         *  2.2 @Transactional 修饰的方法未通过接口调用
         *  2.3 @Transactional 修饰的方法内部捕获异常
         *  2.4 @Transactional 多数据源环境下未指定 transactionManager 参数
 *  3. 解决方案
 *   *   *  3.1 自动管理事务
         *   *  3.1.1 将 Service 服务调用组织到 Controller 中
             *  3.1.2 将数据库的操作组合下沉到仓储层 Repository 中
         *  3.2 手动管理事务

## 1. SpringBoot 中使用事务的正确方式 ##

在 `Spring 框架`中，要让框架自动管理事务需要显式使用 `@EnableTransactionManagement`注解，但是`SpringBoot` 的自动配置机制已经在`org.springframework.boot.autoconfigure.transaction.TransactionAutoConfiguration` 中启用了该注解，故不再需要在启动类上添加这个注解。这样在 SpringBoot 中只要`@Transactional` 注解方法就表明开启了自动事务管理，其正确的使用方式如下

1.  声明接口方法 `Service`
    
        public interface Service {
              
            void updateResult(String req);
        }
2.  在 `ServiceImpl` 接口方法实现上添加注解
    
        public class ServiceImpl implements Service{
              
           // 该对象为数据库操作实例，具体实现此处不表
          @Autowired
          private ResultRepository mResultRepository;
          
          @Transactional
          @Override
          public void updateResult(String req) {
              
              mResultRepository.update(req);
          }
        }
3.  在 `ResultController` 中通过 spring 自动注入的 `Service` 对象来调用 `updateResult()` 方法，即可实现事务管理
    
        @RestController
        public interface ResultController {
              
        
         @Autowired
         private Service service;
         
         @GetMapping(value = "result/update")
         public void updateResult(String req) {
              
             service.updateResult(req);
         }
        }

## 2. @Transactional 注解未生效的原因 ##

#### 2.1 数据库引擎不支持事务 ####

数据库事务是基于数据库引擎的，使用事务首先要保证数据库引擎支持事务。以 MySQL 为例，InnoDB 引擎支持事务，而 MyISAM 引擎不支持事务，这个盲点有时会产生很多不必要的问题

#### 2.2 @Transactional 修饰的方法未通过接口调用 ####

Spring 是采用 AOP 的方式来执行事务的，事务要生效那么AOP必须生效。Spring 中 AOP 实现方式可参考短文 [AOP 的实现方式][AOP]，其两种实现 `JDK 动态代理` 和 `CGLIB 生成子类` 原理都是在目标方法的外部包装一层逻辑，这样在外部调用的时候流程为 `代理类方法-->目标方法`，AOP的增强就生效了。当对象内部方法互相调用，其流程表述为 `代理类方法1-->目标方法1-->目标方法2`，目标方法2 的增强逻辑根本不会被调用，自然AOP 就失效了

#### 2.3 @Transactional 修饰的方法内部捕获异常 ####

方法内部使用 try/catch，异常未被抛出，不会回滚。Spring 自动事务管理通过方法是否抛出异常来决定执行提交还是回滚，默认只有 RuntimeException 才会回滚，但是这个异常范围有点小，rollbackFor 参数指定为 Exception.class 是很有必要的

#### 2.4 @Transactional 多数据源环境下未指定 transactionManager 参数 ####

多数据源环境下如果没有指定 transactionManager 参数，默认的 transactionManager 一般是主库的事务管理器，而如果期望的事务操作不是在主库中，发生错误是显而易见的。另外如果一个事务中涉及到了多个数据库，Spring中的自动事务管理是无法正常进行的，因为当前数据库A操作完之后，Spring 框架会复用已有的数据库连接去操作另一个数据库B，这样大部分情况下就会报出表不存在之类的错误

*  分布式事务可借助其他工具实现，例如 `atomikos`

## 3. 解决方案 ##

#### 3.1 自动管理事务 ####

使用 @Transactional 注解内部调用事务失效的原因就是AOP 失效，但是使用 `AopContext.currentProxy()`来获取代理对象再调用其事务方法被笔者证明可使AOP生效，但是无法使事务生效 ，具体原因有待进一步分析。不过无数的经验证明，仅凭技术无法实现的能力，通常可以通过改变结构来实现。以下两种解决方案笔者更倾向于第一种在 Controller 中重新组织 Service 调用的方式，第二种将数据库操作组合下沉到仓储层的做法在业务复杂时会不可避免地混入业务逻辑，与分层思想有一定出入

##### 3.1.1 将 Service 服务调用组织到 Controller 中 #####

采用上文`SpringBoot中使用事务的正确方式`的例子 ,如果在 `ServiceImpl` 将其重写的`updateResult()`方法分拆成了两部分，一部分是其他逻辑，一部分是更新数据库。显而易见的，添加在内部调用方法 `updateRepository()`上的事务注解不会生效。这时候一个解决的思路就是，将 `updateRepository()`方法向上抽取到 `Service`接口中，将其暴露为外部接口，然后在 Controller 里面重新组织`Service` 方法的调用流程。例如之前在 Controller 中只调用了`service.updateResult(req)`，现在可以组织调用为 `service.updateResult(req);service.updateRepository(req);`

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NTUwNTMxMw_size_16_color_FFFFFF_t_70_pic_center]

public class ServiceImpl implements Service{
        
      @Autowired
      private ResultRepository mResultRepository;
      
      @Override
      public void updateResult(String req) {
        
      // 1. 其他逻辑
      ······
      // 2. 更新数据库
          updateRepository(req);
      }
    
      @Transactional
      public void updateRepository(String req) {
        
          mResultRepository.update(req);
      }
    }

##### 3.1.2 将数据库的操作组合下沉到仓储层 Repository 中 #####

在业务代码中，事务表现比较突出的特性为原子性。通常一个 Dao 接口对应一个数据表 Mapper，但有时我们也可以使用一个聚合的 Dao 接口，使其实现类包含多个数据表 Mapper，并将多个 Mapper 的操作封装在同一个接口方法实现中，这样使用 @Transactional 注解来修饰这个实现方法就能达到事务效果

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NTUwNTMxMw_size_16_color_FFFFFF_t_70_pic_center 1]

#### 3.2 手动管理事务 ####

`手动事务`就是在代码中显式地进行事务操作，与上古时代基于 Java 原生 API 手动管理数据库连接的开发模式完全相同，不过认真说起来即便是那会大部分事务也是通过 Filter 过滤器把数据库连接 DataConnection 放在 ThreadLocal 实现，实现可参考 [TransactionFilter][]。SpringBoot 中手动事务的使用方法如下，需注意此处注入的 `DataSourceTransactionManager` 为默认的数据源的事务管理器，如果在多数据源环境下，需要为每个数据源都配置一个事务管理器，然后注入的时候根据数据源指定其事务管理器

// 注入如下两个对象
    @Resource
    DataSourceTransactionManager dataSourceTransactionManager;
    @Autowired
    TransactionDefinition transactionDefinition;
    
    public void update(){
        
        //开启事务
        TransactionStatus transactionStatus = dataSourceTransactionManager.getTransaction(transactionDefinition);
        try{
        
            this.update();
            //无异常，提交事务
            dataSourceTransactionManager.commit(transactionStatus);
        }catch(Exception e){
        
            //异常，回滚事务
            dataSourceTransactionManager.rollback(transactionStatus);
        }
    }

[AOP]: https://blog.csdn.net/weixin_45505313/article/details/103463974#1_AOP__1
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NTUwNTMxMw_size_16_color_FFFFFF_t_70_pic_center]: https://img-blog.csdnimg.cn/20191203161648234.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NTUwNTMxMw==,size_16,color_FFFFFF,t_70#pic_center
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NTUwNTMxMw_size_16_color_FFFFFF_t_70_pic_center 1]: https://img-blog.csdnimg.cn/20191203164737120.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NTUwNTMxMw==,size_16,color_FFFFFF,t_70#pic_center
[TransactionFilter]: https://github.com/yang00-74/bookstore/blob/master/src/web/filter/TransactionFilter.java