Spring中事務(wù)失效的8種常見使用場景避坑指南
Spring事務(wù)管理是企業(yè)級Java應(yīng)用的核心功能，看似簡單的@Transactional注解，如果使用不當(dāng)將會(huì)引發(fā)嚴(yán)重的生產(chǎn)問題，比如因事務(wù)失效帶來的數(shù)據(jù)不一致問題。
事務(wù)失效往往不會(huì)拋出異常，而是靜默發(fā)生，等到業(yè)務(wù)出現(xiàn)問題時(shí)才被發(fā)現(xiàn)，造成嚴(yán)重的數(shù)據(jù)不一致。
本文將分析8種導(dǎo)致Spring事務(wù)失效的使用問題并提供相應(yīng)的解決方案。
一、事務(wù)注解應(yīng)用在非public方法上
問題現(xiàn)象
開發(fā)者在非public方法上添加@Transactional注解，但事務(wù)沒有生效。
@Service
public class UserService {
@Autowired
private UserMapper userMapper;
// 事務(wù)無效！方法不是public的
@Transactional
protected void createUser(User user) {
userMapper.insert(user);
// 如果這里拋出異常，數(shù)據(jù)不會(huì)回滾
}
}原理分析
Spring AOP的代理機(jī)制默認(rèn)只攔截public方法。這是因?yàn)槭聞?wù)通知是基于Spring AOP實(shí)現(xiàn)的，而Spring AOP默認(rèn)只攔截public方法調(diào)用。
查看AbstractFallbackTransactionAttributeSource類的源碼可以發(fā)現(xiàn)：
// AbstractFallbackTransactionAttributeSource.java
protected TransactionAttribute computeTransactionAttribute(Method method, Class<?> targetClass) {
// Don't allow no-public methods as required.
if (allowPublicMethodsOnly() && !Modifier.isPublic(method.getModifiers())) {
return null;
}
// ...
}非public方法上的@Transactional注解會(huì)被直接忽略，返回null，導(dǎo)致事務(wù)不生效。
解決方案
確保標(biāo)注@Transactional的方法為public：
@Service
public class UserService {
@Autowired
private UserMapper userMapper;
// 正確：方法是public的
@Transactional
public void createUser(User user) {
userMapper.insert(user);
// 如果拋出異常，數(shù)據(jù)會(huì)回滾
}
}二、同一個(gè)類中方法調(diào)用
問題現(xiàn)象
在同一個(gè)類中，非事務(wù)方法調(diào)用事務(wù)方法，或者事務(wù)方法調(diào)用另一個(gè)具有不同事務(wù)屬性的方法，事務(wù)會(huì)失效。
@Service
public class OrderService {
public void createOrder(Order order) {
// 直接調(diào)用同類中的事務(wù)方法
this.createOrderWithTransaction(order);
// 如果createOrderWithTransaction方法拋出異常
// 事務(wù)不會(huì)回滾！
}
@Transactional
public void createOrderWithTransaction(Order order) {
// 數(shù)據(jù)庫操作...
throw new RuntimeException("故意拋出異常");
}
}原理分析
Spring事務(wù)基于動(dòng)態(tài)代理實(shí)現(xiàn)，當(dāng)在同一個(gè)類中調(diào)用方法時(shí)，是通過this引用調(diào)用的，而不是通過代理對象。這導(dǎo)致事務(wù)切面無法攔截方法調(diào)用，事務(wù)自然就失效了。
簡言之，只有通過代理對象調(diào)用方法時(shí)，Spring事務(wù)才會(huì)生效。
解決方案
有幾種方法可以解決：
方法1：使用自我注入
@Service
public class OrderService {
@Autowired
private OrderService self; // 自我注入，注入的是代理對象
public void createOrder(Order order) {
// 通過代理對象調(diào)用事務(wù)方法
self.createOrderWithTransaction(order);
// 如果createOrderWithTransaction方法拋出異常
// 事務(wù)會(huì)正常回滾
}
@Transactional
public void createOrderWithTransaction(Order order) {
// 數(shù)據(jù)庫操作...
throw new RuntimeException("故意拋出異常");
}
}方法2：使用AopContext獲取代理對象（需要額外配置）
@EnableAspectJAutoProxy(exposeProxy = true) // 配置類上添加此注解
public class AppConfig {
// ...
}
@Service
public class OrderService {
public void createOrder(Order order) {
// 通過AopContext獲取代理對象
((OrderService) AopContext.currentProxy())
.createOrderWithTransaction(order);
// 事務(wù)會(huì)正常工作
}
@Transactional
public void createOrderWithTransaction(Order order) {
// 數(shù)據(jù)庫操作...
throw new RuntimeException("故意拋出異常");
}
}方法3：將方法拆分到不同的類中
@Service
public class OrderFacadeService {
@Autowired
private TransactionalOrderService orderService;
public void createOrder(Order order) {
orderService.createOrderWithTransaction(order);
// 事務(wù)會(huì)正常工作
}
}
@Service
public class TransactionalOrderService {
@Transactional
public void createOrderWithTransaction(Order order) {
// 數(shù)據(jù)庫操作...
throw new RuntimeException("故意拋出異常");
}
}三、異常被吞沒
問題現(xiàn)象
開發(fā)者在事務(wù)方法中捕獲了異常但沒有重新拋出，導(dǎo)致事務(wù)無法回滾。
@Service
public class PaymentService {
@Autowired
private PaymentMapper paymentMapper;
@Transactional
public void processPayment(Payment payment) {
try {
paymentMapper.insert(payment);
// 其他業(yè)務(wù)邏輯
throw new RuntimeException("支付處理失敗");
} catch (Exception e) {
log.error("支付異常", e);
// 錯(cuò)誤：捕獲異常但未重新拋出，事務(wù)不會(huì)回滾
}
}
}原理分析
Spring事務(wù)管理器是通過異常觸發(fā)回滾的。當(dāng)方法執(zhí)行過程中拋出異常，并且這個(gè)異常滿足回滾條件時(shí)，事務(wù)管理器才會(huì)執(zhí)行回滾操作。如果異常被捕獲且沒有重新拋出，Spring事務(wù)管理器就不知道發(fā)生了異常，自然不會(huì)回滾事務(wù)。
解決方案
有兩種解決方法：
方法1：重新拋出異常
@Service
public class PaymentService {
@Autowired
private PaymentMapper paymentMapper;
@Transactional
public void processPayment(Payment payment) {
try {
paymentMapper.insert(payment);
// 其他業(yè)務(wù)邏輯
throw new RuntimeException("支付處理失敗");
} catch (Exception e) {
log.error("支付異常", e);
// 正確：重新拋出異常，事務(wù)會(huì)回滾
throw e; // 或者拋出新的異常
}
}
}方法2：使用TransactionAspectSupport手動(dòng)回滾
@Service
public class PaymentService {
@Autowired
private PaymentMapper paymentMapper;
@Transactional
public void processPayment(Payment payment) {
try {
paymentMapper.insert(payment);
// 其他業(yè)務(wù)邏輯
throw new RuntimeException("支付處理失敗");
} catch (Exception e) {
log.error("支付異常", e);
// 正確：手動(dòng)標(biāo)記事務(wù)回滾
TransactionAspectSupport.currentTransactionStatus().setRollbackOnly();
}
}
}四、異常類型不匹配回滾規(guī)則
問題現(xiàn)象
開發(fā)者拋出了異常，但事務(wù)沒有回滾。這通常是因?yàn)閽伋龅漠惓ｎ愋筒粷M足默認(rèn)的回滾規(guī)則。
@Service
public class ReportService {
@Autowired
private ReportMapper reportMapper;
@Transactional
public void generateReport() {
reportMapper.insertReportData();
// 其他業(yè)務(wù)邏輯
if (somethingWrong()) {
// 拋出受檢異常，默認(rèn)不會(huì)導(dǎo)致事務(wù)回滾
throw new IOException("報(bào)告生成失敗");
}
}
}原理分析
Spring默認(rèn)只在遇到未檢查異常（RuntimeException及其子類）和Error時(shí)才回滾事務(wù)。受檢異常（如IOException、SQLException）被認(rèn)為是業(yè)務(wù)異常，默認(rèn)情況下不會(huì)觸發(fā)事務(wù)回滾。
這是因?yàn)?code>@Transactional注解的默認(rèn)配置是：
@Transactional(rollbackFor = RuntimeException.class)
解決方案
有兩種解決方法：
方法1：指定回滾的異常類型
@Service
public class ReportService {
@Autowired
private ReportMapper reportMapper;
// 正確：指定回滾的異常類型包括IOException
@Transactional(rollbackFor = {IOException.class})
public void generateReport() throws IOException {
reportMapper.insertReportData();
// 其他業(yè)務(wù)邏輯
if (somethingWrong()) {
throw new IOException("報(bào)告生成失敗");
// 現(xiàn)在會(huì)觸發(fā)事務(wù)回滾
}
}
}方法2：將受檢異常轉(zhuǎn)換為非受檢異常
@Service
public class ReportService {
@Autowired
private ReportMapper reportMapper;
@Transactional
public void generateReport() {
reportMapper.insertReportData();
// 其他業(yè)務(wù)邏輯
try {
if (somethingWrong()) {
throw new IOException("報(bào)告生成失敗");
}
} catch (IOException e) {
// 將受檢異常轉(zhuǎn)換為非受檢異常
throw new RuntimeException("報(bào)告生成失敗", e);
// 現(xiàn)在會(huì)觸發(fā)事務(wù)回滾
}
}
}五、數(shù)據(jù)庫不支持事務(wù)
問題現(xiàn)象
所有事務(wù)配置看起來都正確，但事務(wù)仍然不生效。
原理分析
某些數(shù)據(jù)庫引擎不支持事務(wù)功能。最常見的例子是MySQL的MyISAM引擎，它不支持事務(wù)操作。如果表使用的是MyISAM引擎，即使Spring事務(wù)配置正確，也無法實(shí)現(xiàn)事務(wù)回滾。
解決方案
確保使用支持事務(wù)的數(shù)據(jù)庫引擎：
1. 對于MySQL，使用InnoDB引擎而不是MyISAM
2. 檢查表的創(chuàng)建語句，確保引擎類型正確：
-- 檢查表引擎 SHOW TABLE STATUS WHERE Name = 'your_table_name'; -- 修改表引擎為InnoDB ALTER TABLE your_table_name ENGINE=InnoDB;
六、錯(cuò)誤的傳播行為設(shè)置
問題現(xiàn)象
在嵌套事務(wù)場景中，內(nèi)部事務(wù)的回滾沒有按照預(yù)期工作。
@Service
public class OrderService {
@Autowired
private PaymentService paymentService;
@Transactional
public void createOrder(Order order) {
// 保存訂單
orderMapper.insert(order);
try {
// 調(diào)用支付服務(wù)
paymentService.processPayment(order.getPayment());
} catch (Exception e) {
log.error("支付失敗，但訂單已創(chuàng)建", e);
// 處理支付失敗邏輯，但期望訂單依然保存
}
}
}
@Service
public class PaymentService {
// 錯(cuò)誤的傳播行為，會(huì)影響外部事務(wù)
@Transactional(propagation = Propagation.REQUIRED)
public void processPayment(Payment payment) {
paymentMapper.insert(payment);
throw new RuntimeException("支付處理失敗");
}
}原理分析
Spring提供了不同的事務(wù)傳播行為，用于控制事務(wù)的邊界。最常用的是：
REQUIRED：默認(rèn)值，如果當(dāng)前存在事務(wù)，則加入該事務(wù)；如果不存在，則創(chuàng)建新事務(wù)REQUIRES_NEW：創(chuàng)建新事務(wù)，如果當(dāng)前存在事務(wù)，則掛起當(dāng)前事務(wù)NESTED：如果當(dāng)前存在事務(wù)，則創(chuàng)建嵌套事務(wù)；如果不存在，則等同于REQUIREDSUPPORTS：如果當(dāng)前存在事務(wù)，則加入該事務(wù)；如果不存在，則以非事務(wù)方式執(zhí)行
使用不當(dāng)?shù)膫鞑バ袨闀?huì)導(dǎo)致事務(wù)范圍不符合預(yù)期，特別是在異常處理場景中。
解決方案
根據(jù)業(yè)務(wù)需求選擇正確的傳播行為：
@Service
public class OrderService {
@Autowired
private PaymentService paymentService;
@Transactional
public void createOrder(Order order) {
// 保存訂單
orderMapper.insert(order);
try {
// 調(diào)用支付服務(wù)
paymentService.processPayment(order.getPayment());
} catch (Exception e) {
log.error("支付失敗，但訂單已創(chuàng)建", e);
// 處理支付失敗邏輯，但期望訂單依然保存
}
}
}
@Service
public class PaymentService {
// 正確：使用REQUIRES_NEW創(chuàng)建獨(dú)立事務(wù)
@Transactional(propagation = Propagation.REQUIRES_NEW)
public void processPayment(Payment payment) {
paymentMapper.insert(payment);
throw new RuntimeException("支付處理失敗");
// 只有支付事務(wù)會(huì)回滾，不影響外部訂單事務(wù)
}
}傳播行為選擇指南：
1. 如果希望內(nèi)部方法的異常不影響外部事務(wù)：使用REQUIRES_NEW
2. 如果希望內(nèi)部方法的回滾不影響外部事務(wù)，但共享同一連接：使用NESTED（注意，這需要數(shù)據(jù)庫支持保存點(diǎn)）
3. 如果希望完全共享外部事務(wù)的命運(yùn)：使用REQUIRED
七、未被Spring管理的類
問題現(xiàn)象
在類上添加了@Transactional注解，但事務(wù)沒有生效。
// 未被Spring容器管理！
public class UserService {
@Autowired
private UserMapper userMapper;
@Transactional
public void createUser(User user) {
userMapper.insert(user);
throw new RuntimeException("測試");
// 事務(wù)不會(huì)回滾
}
}原理分析
Spring事務(wù)是通過AOP實(shí)現(xiàn)的，只有被Spring容器管理的Bean才能被代理，進(jìn)而應(yīng)用事務(wù)切面。如果類沒有被Spring正確識(shí)別為Bean，@Transactional注解就無法生效。
常見的原因包括：
1. 類上缺少@Component、@Service等注解
2. 類沒有被組件掃描到
3. 類是通過new關(guān)鍵字直接創(chuàng)建的實(shí)例
解決方案
確保類被Spring容器管理：
@Service // 正確：添加@Service注解
public class UserService {
@Autowired
private UserMapper userMapper;
@Transactional
public void createUser(User user) {
userMapper.insert(user);
throw new RuntimeException("測試");
// 現(xiàn)在事務(wù)會(huì)正?；貪L
}
}同時(shí)，確保組件掃描配置正確：
@Configuration
@ComponentScan("com.example.service") // 確保包路徑正確
public class AppConfig {
// ...
}八、事務(wù)管理器配置錯(cuò)誤
問題現(xiàn)象
使用了正確的事務(wù)注解，但事務(wù)不生效或者出現(xiàn)異常。
原理分析
Spring支持多種事務(wù)管理器，針對不同的持久化技術(shù)：
- •
DataSourceTransactionManager：適用于JDBC和MyBatis - •
JpaTransactionManager：適用于JPA - •
HibernateTransactionManager：適用于Hibernate
如果配置了錯(cuò)誤的事務(wù)管理器，或者在多數(shù)據(jù)源環(huán)境中未指定正確的事務(wù)管理器，會(huì)導(dǎo)致事務(wù)失效。
解決方案
單數(shù)據(jù)源環(huán)境：確保配置正確的事務(wù)管理器
@Configuration
@EnableTransactionManagement
public class DatabaseConfig {
@Bean
public DataSource dataSource() {
// 數(shù)據(jù)源配置...
return new HikariDataSource();
}
@Bean
public PlatformTransactionManager transactionManager(DataSource dataSource) {
// 使用與持久化技術(shù)匹配的事務(wù)管理器
return new DataSourceTransactionManager(dataSource);
}
}多數(shù)據(jù)源環(huán)境：指定使用的事務(wù)管理器
@Configuration
@EnableTransactionManagement
public class MultiDatabaseConfig {
@Bean
public DataSource primaryDataSource() {
// 主數(shù)據(jù)源配置...
return new HikariDataSource();
}
@Bean
public DataSource secondaryDataSource() {
// 次數(shù)據(jù)源配置...
return new HikariDataSource();
}
@Bean
public PlatformTransactionManager primaryTransactionManager() {
return new DataSourceTransactionManager(primaryDataSource());
}
@Bean
public PlatformTransactionManager secondaryTransactionManager() {
return new DataSourceTransactionManager(secondaryDataSource());
}
}
@Service
public class UserService {
// 指定使用的事務(wù)管理器
@Transactional(transactionManager = "primaryTransactionManager")
public void createUser(User user) {
// 使用主數(shù)據(jù)源的操作
}
@Transactional(transactionManager = "secondaryTransactionManager")
public void createUserLog(UserLog log) {
// 使用次數(shù)據(jù)源的操作
}
}總結(jié)
Spring事務(wù)是一個(gè)強(qiáng)大的特性，但也隱藏著許多陷阱。理解這些陷阱的原理，可以幫助你更好地利用Spring事務(wù)，構(gòu)建更加健壯的應(yīng)用程序。
到此這篇關(guān)于Spring中事務(wù)失效的8種常見使用場景避坑指南的文章就介紹到這了,更多相關(guān)Spring事務(wù)失效內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！
相關(guān)文章
使用Java將實(shí)體類轉(zhuǎn)換為JSON并輸出到控制臺(tái)的完整過程
在軟件開發(fā)的過程中,Java是一種廣泛使用的編程語言,而在眾多應(yīng)用中,數(shù)據(jù)的傳輸和存儲(chǔ)經(jīng)常需要使用JSON格式,用Java將實(shí)體類轉(zhuǎn)換為JSON格式并輸出其實(shí)不難,只需掌握幾個(gè)步驟就可以做到！接下來,我們來看看這一過程究竟是如何實(shí)現(xiàn)的,感興趣的小伙伴跟著小編一起來看看吧2025-05-05
Java單線程程序?qū)崿F(xiàn)實(shí)現(xiàn)簡單聊天功能
這篇文章主要介紹了Java單線程程序?qū)崿F(xiàn)實(shí)現(xiàn)簡單聊天功能,文中通過示例代碼介紹的非常詳細(xì)，對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友可以參考下2020-10-10
這篇文章主要介紹了java連接ElasticSearch集群操作，具有很好的參考價(jià)值，希望對大家有所幫助。一起跟隨小編過來看看吧2020-09-09
這篇文章主要介紹了SpringBoot集成SpringMVC的方法示例，文中通過示例代碼介紹的非常詳細(xì)，對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2021-01-01
Java中String類getBytes()方法詳解與完整實(shí)例
這篇文章主要給大家介紹了關(guān)于Java中String類getBytes()方法詳解與完整實(shí)例的相關(guān)資料,getBytes()是Java編程語言中將一個(gè)字符串轉(zhuǎn)化為一個(gè)字節(jié)數(shù)組byte[]的方法,需要的朋友可以參考下2023-10-10
這篇文章主要介紹了SpringMVC中文亂碼踩坑記錄,本文通過實(shí)例代碼給大家介紹的非常詳細(xì)，對大家的學(xué)習(xí)或工作具有一定的參考借鑒價(jià)值，需要的朋友可以參考下2021-08-08
SpringCloud?Gateway?DispatcherHandler調(diào)用方法詳細(xì)介紹
我們第一個(gè)關(guān)注的類就是DispatcherHandler，這個(gè)類提供的handle()方法，封裝了我們之后所有的handlerMappings，這個(gè)DispatcherHandler有點(diǎn)想SpringMVC的DispatchServlet，里面也是封裝了請求和對應(yīng)的處理方法的關(guān)系2022-10-10
SpringBoot中注解@ConfigurationProperties與@Value的區(qū)別與使用詳解
本文主要介紹了SpringBoot中注解@ConfigurationProperties與@Value的區(qū)別與使用，具有一定的參考價(jià)值，感興趣的小伙伴們可以參考一下2021-09-09
Springboot集成MongoDB無認(rèn)證與開啟認(rèn)證的配置方式
本文主要介紹了Springboot集成MongoDB無認(rèn)證與開啟認(rèn)證的配置方式，文中通過示例代碼介紹的非常詳細(xì)，對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2024-03-03
Stream是Java8中處理集合的關(guān)鍵抽象概念,它可以指定你希望對集合進(jìn)行的操作,可以執(zhí)行非常復(fù)雜的查找、過濾和映射數(shù)據(jù)等操作,這篇文章主要給大家介紹了Java8中Stream的一些神操作,需要的朋友可以參考下2021-11-11