引言

在 Spring Boot 項目開發(fā)中，聲明式事務管理通過 @Transactional 注解提供了極大的便利。

但許多開發(fā)者都曾遇到過事務不生效的困擾。

本文將詳細分析導致 Spring Boot 事務失效的八大常見情況，并提供相應的解決方案。

1. 數(shù)據(jù)庫引擎不支持事務

問題分析：這是最根本的原因。如果數(shù)據(jù)庫存儲引擎本身不支持事務（如 MySQL 的 MyISAM），那么無論 Spring 如何配置，事務都不會生效。

解決方案：

• 確保你的數(shù)據(jù)庫表使用支持事務的引擎，如 MySQL 的 InnoDB
• 建表時指定存儲引擎：CREATE TABLE ... ENGINE=InnoDB;

2. 事務方法非 public 修飾

問題分析：@Transactional 基于 Spring AOP 實現(xiàn)，而 AOP 代理默認無法攔截非 public 方法。

@Service
public class UserService {
    @Transactional // 失效！
    private void createUser(User user) {
        userMapper.insert(user);
    }
}

解決方案：

• 始終將 @Transactional 注解應用于 public 方法上

3. 自調(diào)用問題（Within-Class Invocation）

問題分析：這是最常見且最容易踩坑的原因。當一個類中的非事務方法調(diào)用同一個類中的 @Transactional 方法時，事務不會生效。

@Service
public class UserService {
    
    public void createUser(User user) {
        // 一些非事務操作
        this.insertUser(user); // 自調(diào)用，事務失效！
    }
    
    @Transactional
    public void insertUser(User user) {
        userMapper.insert(user);
        // 如果這里出現(xiàn)異常，事務不會回滾
    }
}

解決方案：

• 推薦方案：將事務方法抽取到另一個 Service 類中
• 通過 ApplicationContext 獲取代理對象調(diào)用（不優(yōu)雅）
• 使用 AspectJ 模式的事務管理（配置復雜）

4. 異常類型不正確或被捕獲

問題分析：@Transactional 默認只在拋出運行時異常（RuntimeException）和 Error 時回滾。

@Transactional
public void method() throws Exception {
    // 數(shù)據(jù)庫操作
    throw new Exception("受檢異常"); // 事務不會回滾！
}

另一個陷阱：異常被捕獲但未重新拋出

@Transactional
public void method() {
    try {
        int i = 1 / 0; // 拋出 RuntimeException
    } catch (Exception e) {
        e.printStackTrace(); // 只是打印，事務不會回滾！
    }
}

解決方案：

• 使用 rollbackFor 屬性指定回滾的異常類型：

@Transactional(rollbackFor = Exception.class)

• 在 catch 塊中重新拋出運行時異常

5. 傳播行為（Propagation）設置不當

問題分析：錯誤配置傳播行為會導致意外結果。

@Transactional(propagation = Propagation.NOT_SUPPORTED) // 不以事務運行
public void method() {
    // 這里沒有事務
}

解決方案：

• 根據(jù)業(yè)務需求正確配置傳播行為
• 理解各種傳播行為的含義：

• • REQUIRED（默認）：支持當前事務，不存在則新建
  • REQUIRES_NEW：新建事務，掛起當前事務
  • NOT_SUPPORTED：非事務方式執(zhí)行
  • NEVER：非事務方式執(zhí)行，存在事務則拋出異常

6. 未被 Spring 容器管理

問題分析：如果類沒有加上 @Service, @Component 等注解，它就不是 Spring Bean，其上的 @Transactional 注解不會被掃描。

// 缺少 @Service 注解
public class UserService {
    @Transactional // 失效！
    public void createUser(User user) {
        // ...
    }
}

解決方案：

• 確保類被 Spring 管理，添加適當?shù)淖⒔?/li>

7. 多線程環(huán)境下調(diào)用

問題分析：事務信息存儲在 ThreadLocal 中，新線程中的操作不屬于原事務。

@Transactional
public void method() {
    new Thread(() -> {
        userMapper.insert(user); // 不在事務中！
    }).start();
}

解決方案：

• 避免在事務方法中創(chuàng)建異步線程進行數(shù)據(jù)庫操作
• 使用分布式事務解決方案處理跨線程事務

8. 配置問題

問題分析：

• 未開啟事務管理（雖然 Spring Boot 會自動配置）
• 多數(shù)據(jù)源未正確配置事務管理器

解決方案：

• 確保配置了 @EnableTransactionManagement（Spring Boot 通常自動配置）
• 多數(shù)據(jù)源時為每個數(shù)據(jù)源配置對應的事務管理器：

@Bean
public PlatformTransactionManager transactionManager(DataSource dataSource) {
    return new DataSourceTransactionManager(dataSource);
}

• 使用 @Transactional(value = "txManagerName") 指定事務管理器

事務調(diào)試技巧

開啟事務調(diào)試日志，在 application.properties 中添加：

logging.level.org.springframework.transaction.interceptor=TRACE
logging.level.org.springframework.jdbc.datasource.DataSourceTransactionManager=DEBUG

這將幫助你看清事務何時開啟、回滾或提交。

總結

Spring Boot 事務失效通常由以上八大原因?qū)е?，其中自調(diào)用問題最為常見。要確保事務正常工作，需要：

1. 使用支持事務的數(shù)據(jù)庫引擎（如 InnoDB）
2. 將 @Transactional 應用于 public 方法
3. 避免自調(diào)用，將事務方法放在不同類中
4. 正確處理異常，確保異常能夠觸發(fā)回滾
5. 正確配置傳播行為
6. 確保 Bean 被 Spring 管理
7. 避免多線程事務問題
8. 檢查事務相關配置

希望本文能幫助你有效解決 Spring Boot 中的事務失效問題。

以上就是SpringBoot事務失效的八大原因及解決方案的詳細內(nèi)容，更多關于SpringBoot事務失效原因及解決的資料請關注腳本之家其它相關文章！

最新評論