引言

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

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

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

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

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

解決方案：

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

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

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

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

解決方案：

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

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

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

@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ù)不會(huì)回滾
    }
}

解決方案：

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

4. 異常類(lèi)型不正確或被捕獲

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

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

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

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

解決方案：

• 使用 rollbackFor 屬性指定回滾的異常類(lèi)型：

@Transactional(rollbackFor = Exception.class)

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

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

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

@Transactional(propagation = Propagation.NOT_SUPPORTED) // 不以事務(wù)運(yùn)行
public void method() {
    // 這里沒(méi)有事務(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 容器管理

問(wèn)題分析：如果類(lèi)沒(méi)有加上 @Service, @Component 等注解，它就不是 Spring Bean，其上的 @Transactional 注解不會(huì)被掃描。

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

解決方案：

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

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

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

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

解決方案：

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

8. 配置問(wèn)題

問(wèn)題分析：

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

解決方案：

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

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

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

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

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

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

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

總結(jié)

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

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

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

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

最新評(píng)論