記一次實際開發過程中遇到事務報錯問題 Transaction synchronization is not active


一:問題場景

  在一次http請求的后台接口中返回結果中出現了這個錯誤信息“Transaction synchronization is not active”,意思是“事務同步器沒有激活”,但是被調用的接口已經添加了@Transactional注解,所以百思不得不得其解為什么還會報這個錯誤,那么是什么原因引起了這個異常呢?自己通過百度大神博客終於找到一篇相似的文章解決了自己的問題,今天就是把解決方案記錄下來為以后再出現類似情況提供解決方案。

二:出現原因

  Google搜索一番之后,發現了這篇文章Spring的TransactionEventListener,文中提到了可能出現這個錯誤信息的一種情況:

  @EventListener
  public void afterRegisterSendMail(MessageEvent event) {
    // Spring 4.2 之前
    TransactionSynchronizationManager.registerSynchronization(
      new TransactionSynchronizationAdapter() {
        @Override
        public void afterCommit() {
          internalSendMailNotification(event);
      }
    });
  }
  上面的代碼將在事務提交后執行.如果在非事務context中(就是方法未開啟spring事務)將拋出java.lang.IllegalStateException: Transaction synchronization is not active

  於是找到自己代碼中的TransactionSynchronizationManager部分,果然在當前http請求鏈路中的一個接口里發現了類似的代碼:

  TransactionSynchronizationManager.registerSynchronization(new TransactionSynchronization() {
    @Override
    public void afterCommit() {
      try {
        byte[] bytes = JSON.toJSONBytes(task, new SerializeConfig());
        MessageProperties messageProperties = new MessageProperties();
        messageProperties.setMessageId(idWorker.nextStringId());
        Message message = new Message(bytes, messageProperties);
        salaryFileMsgProducer.sendSalaryFileMsg(message);
      } catch (Exception e) {
        log.error(e.getMessage());
        e.printStackTrace();
      }
    }
  });

  想必是執行這段代碼的時候報的異常,但是上面那篇文章說了引起這個異常的原因是“在非事務context中注冊同步器”,難道當前事務沒有開啟?我們的業務代碼一般都是使用spring的注解@Transactional來開啟事務,那么去看一下開啟事務的代碼片段。

三:根本原因
  我在調用TransactionSynchronizationManager.registerSynchronization()的方法體上找到了@Transactional注解,方法代碼如下,省略具體實現:

  @Transactional(rollbackFor = Exception.class)
  public Boolean creatSalaryMonthStatistic(SalaryMonthlyStatistic salaryMonthlyStatistic){
    ....
  }
  這就奇怪了,明明方法上已經添加@Transactional注解開啟事務,為什么事務開啟失敗,帶着這個疑問再次求助了Google,發現了這篇博客spring的service類調用自己方法事務無效,作者也遇到了事務無效的問題,其中總結了事務有效性相關的幾點重要信息:

  1.在需要事務管理的地方加@Transactional 注解。@Transactional 注解可以被應用於接口定義和接口方法、類定義和類的 public 方法上。

  2.@Transactional 注解只能應用到 public 可見度的方法上。 如果你在 protected、private 或者 package-visible 的方法上使用 @Transactional 注解,它也不會報錯, 但是這個被注解的方法將不會展示已配置的事務設置。

  3.注意僅僅 @Transactional 注解的出現不足於開啟事務行為,它僅僅 是一種元數據。必須在配置文件中使用配置元素,才真正開啟了事務行為。(spring配置文件中,開啟聲明式事務)

  4.通過 元素的 “proxy-target-class” 屬性值來控制是基於接口的還是基於類的代理被創建。如果 “proxy-target-class” 屬值被設置為 “true”,那么基於類的代理將起作用(這時需要CGLIB庫cglib.jar在CLASSPATH中)。如果 “proxy-target-class” 屬值被設置為 “false” 或者這個屬性被省略,那么標准的JDK基於接口的代理將起作用。

  5.Spring團隊建議在具體的類(或類的方法)上使用 @Transactional 注解,而不要使用在類所要實現的任何接口上。在接口上使用 @Transactional 注解,只能當你設置了基於接口的代理時它才生效。因為注解是 不能繼承 的,這就意味着如果正在使用基於類的代理時,那么事務的設置將不能被基於類的代理所識別,而且對象也將不會被事務代理所包裝。

  6.@Transactional的事務開啟 ,或者是基於接口的 或者是基於類的代理被創建。所以在同一個類中一個無事務的方法調用另一個有事務的方法,事務是不會起作用的。

特別注意第6點:同一個類中一個無事務的方法調用另一個有事務的方法,事務是不會起作用的。這一點引起了我的注意,可能我的加了注解@Transactional的creatSalaryMonthStatistic方法也是被類里另一個沒有開啟事務的方法調用,如果真的是這樣,所有一切都解釋的通了。所以帶着這個思路檢查了一遍自己的代碼,

  果然,creatSalaryMonthStatistic方法被一個沒加事務的接口方法調用,從而整個creatSalaryMonthStatistic方法都沒有事務效果:

  //此接口方法未加事務
  public Boolean batchInitSalaryFileDataTask4Tenant(String tenantId){
    .....
    salaryFileInitTaskBiz.createSalaryFileDateInitTask4Staff(file);
    .....
  }
四:解決方案
  知道了引起問題的原因,解決方法也比較簡單,有好幾種方法都可以解決這個問題,可以根據個人需要選擇一種解決方法,本文列出其中三種:
  1.比較方便、暴力的一種方法就是直接在最外層接口方法中添加事務注解,也就是給本文中的batchInitSalaryFileDataTask4Tenant方法加上注解即可。
  2.也可以通過代理類調用creatSalaryMonthStatistic方法,代理類中包含了事務邏輯,這樣也能實現事務功能。
  3.還可以直接將creatSalaryMonthStatistic這個方法放到另外一個類中。


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM