一:問題場景
在一次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這個方法放到另外一個類中。