引言

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

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

本文將詳細(xì)分析導(dǎo)致 Spring Boot 事務(wù)失效的八大常見情況，并提供相應(yīng)的解決方案。

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

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

解決方案：

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

2. 事務(wù)方法非 public 修飾

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

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

解決方案：

• 始終將 @Transactional 注解應(yīng)用于 public 方法上

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

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

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

解決方案：

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

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

問題分析：@Transactional 默認(rèn)只在拋出運(yùn)行時(shí)異常（RuntimeException）和 Error 時(shí)回滾。

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

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

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

解決方案：

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

@Transactional(rollbackFor = Exception.class)

• 在 catch 塊中重新拋出運(yùn)行時(shí)異常

5. 傳播行為（Propagation）設(shè)置不當(dāng)

問題分析：錯(cuò)誤配置傳播行為會導(dǎo)致意外結(jié)果。

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

解決方案：

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

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

6. 未被 Spring 容器管理

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

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

解決方案：

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

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

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

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

解決方案：

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

8. 配置問題

問題分析：

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

解決方案：

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

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

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

事務(wù)調(diào)試技巧

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

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

這將幫助你看清事務(wù)何時(shí)開啟、回滾或提交。

總結(jié)

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

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

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

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