腳本之家服務(wù)器常用軟件

快捷導(dǎo)航

Spring事務(wù)失效的9大場景與解決方法

更新時間：2025年04月30日 09:29:48 作者：寫bug寫bug

在日常開發(fā)中,我們經(jīng)常使用Spring事務(wù),這篇文章主要來和大家聊聊Spring事務(wù)失效的 9 種場景,并提供了相應(yīng)的解決方法,有需要的小伙伴可以參考一下

前言
1. 拋出檢查異常（checked exceptions）
2. 業(yè)務(wù)方法本身捕獲并處理了異常
3. 同一個類中的方法調(diào)用
4. 方法使用了final或static關(guān)鍵字
5. 方法不是public
6. 傳播機制使用不當(dāng)
7. 沒有被 Spring 管理
8. 多線程調(diào)用
9. 沒有配置開啟事務(wù)
總結(jié)

前言

在日常開發(fā)中，我們經(jīng)常使用Spring事務(wù)。最近，一個朋友去面試，被問到了這樣一個面試題：在什么情況下，Spring 事務(wù)會失效？

今天，我將和大家聊聊Spring事務(wù)失效的 9 種場景。

1. 拋出檢查異常（checked exceptions）

例如，你的事務(wù)控制代碼如下：

@Transactional
public void transactionTest() throws IOException {
    User user = new User();
    UserService.insert(user);
    throw new IOException();
}

如果沒有特別指定@Transactional，Spring 默認(rèn)只會在遇到運行時異常RuntimeException或錯誤時回滾，而檢查異常如IOException不會觸發(fā)回滾。

public boolean rollbackOn(Throwable ex) {
    return (ex instanceof RuntimeException || ex instanceof Error);
}

解決方案：

知道原因后，解決方案也很簡單。配置rollbackFor屬性，例如：@Transactional(rollbackFor = Exception.class)。

@Transactional(rollbackFor = Exception.class)
public void transactionTest() throws IOException {
    User user = new User();
    UserService.insert(user);
    throw new IOException();
}

2. 業(yè)務(wù)方法本身捕獲并處理了異常

@Transactional(rollbackFor = Exception.class)
public void transactionTest() {
    try {
        User user = new User();
        UserService.insert(user);
        int i = 1 / 0;
    } catch (Exception e) {
        e.printStackTrace();
    }
}

在這個場景中，事務(wù)失效的原因也很簡單。Spring 是否回滾事務(wù)取決于你是否拋出了異常。如果你自己捕獲了異常，Spring 就無法處理事務(wù)了。

看了上面的代碼，你可能會覺得這么簡單的問題，自己不可能犯這種低級錯誤。但我想告訴你，我身邊幾乎有一半的人都曾因此困擾過。

在編寫業(yè)務(wù)代碼時，代碼可能會更復(fù)雜，有很多嵌套的方法。稍不注意，就很容易觸發(fā)這個問題。舉個簡單的例子，假設(shè)你有一個審計功能，每次方法執(zhí)行完后，將審計結(jié)果保存到數(shù)據(jù)庫中。那么代碼可能會寫成這樣：

@Service
public class TransactionService {
    @Transactional(rollbackFor = Exception.class)
    public void transactionTest() throws IOException {
        User user = new User();
        UserService.insert(user);
        throw new IOException();
    }
}

下面的切面會作用于TransactionService：

@Component
publicclass AuditAspect {
    @Autowired
    private AuditService auditService;

    @Around(value = "execution (* com.dylan.service.*.*(..))")
    public Object around(ProceedingJoinPoint pjp) {
        try {
            Audit audit = new Audit();
            Signature signature = pjp.getSignature();
            MethodSignature methodSignature = (MethodSignature) signature;
            String[] strings = methodSignature.getParameterNames();
            audit.setMethod(signature.getName());
            audit.setParameters(strings);
            Object proceed = pjp.proceed();
            audit.success(true);
            return proceed;
        } catch (Throwable e) {
            log.error("{}", e);
            audit.success(false);
        }
        auditService.save(audit);
        returnnull;
    }
}

在上面的例子中，如果程序執(zhí)行異常，事務(wù)也會失效。原因是Spring的事務(wù)切面優(yōu)先級最低。如果異常被切面捕獲，Spring 自然無法正確處理事務(wù)，因為事務(wù)管理器無法捕獲到異常。

解決方案：

只需移除try-catch。雖然我們知道在處理事務(wù)時，業(yè)務(wù)代碼不能自己捕獲異常，但只要代碼變得復(fù)雜，我們很容易不小心犯錯。

3. 同一個類中的方法調(diào)用

@Service
publicclass DefaultTransactionService implements Service {

    public void saveUser() throws Exception {
        // do something
        doInsert();
    }

    @Transactional(rollbackFor = Exception.class)
    public void doInsert() throws IOException {
        User user = new User();
        UserService.insert(user);
        thrownew IOException();
    }
}

這也是一個容易出錯的場景。事務(wù)失效的原因也很簡單。因為 Spring 的事務(wù)管理功能是通過動態(tài)代理實現(xiàn)的，而 Spring 默認(rèn)使用 JDK 動態(tài)代理，JDK 動態(tài)代理通過接口實現(xiàn)，并通過反射調(diào)用目標(biāo)類。簡單理解，在saveUser()方法中，調(diào)用this.doInsert()時，this是真實對象，因此會直接執(zhí)行doInsert的業(yè)務(wù)邏輯，而不是代理邏輯，從而導(dǎo)致事務(wù)失效。

解決方案：

方案 1：直接在saveUser方法上添加@Transactional注解。

方案 2：可以將這兩個方法拆分到不同的類中。

方案 3：不使用注解實現(xiàn)事務(wù)，而是使用編程式事務(wù)來包裹需要開啟事務(wù)的代碼塊。例如：transactionTemplate.execute()。

public void doInsert() throws IOException {
    transactionTemplate.execute(() -> {
        User user = new User();
        UserService.insert(user);
        throw new IOException();
    });
}

4. 方法使用了final或static關(guān)鍵字

如果 Spring 使用 Cglib 代理實現(xiàn)（當(dāng)你的代理類沒有實現(xiàn)接口時），而你的業(yè)務(wù)方法恰好使用了final或static關(guān)鍵字，那么事務(wù)控制也會失效。因為 Cglib 使用字節(jié)碼增強技術(shù)生成被代理類的子類，并重寫被代理類的方法來實現(xiàn)代理。如果被代理的方法使用了final或static關(guān)鍵字，子類就無法重寫被代理的方法。

如果 Spring 使用 JDK 動態(tài)代理實現(xiàn)，JDK 動態(tài)代理是基于接口實現(xiàn)的，那么被final和static修飾的方法也無法被代理。

總之，如果方法連代理都沒有，那么事務(wù)回滾肯定無法實現(xiàn)。

解決方案：

盡量移除方法上的final或static關(guān)鍵字。

5. 方法不是public

如果方法不是public，Spring 事務(wù)也會失效，因為在 Spring 事務(wù)管理的源碼AbstractFallbackTransactionAttributeSource中，computeTransactionAttribute()方法會判斷目標(biāo)方法是否是public。如果不是public，則返回null。

// Don't allow no-public methods as required.
if (allowPublicMethodsOnly() && !Modifier.isPublic(method.getModifiers())) {
    return null;
}

解決方案：

將當(dāng)前方法的訪問級別改為public。

6. 傳播機制使用不當(dāng)

Spring事務(wù)的傳播機制指的是當(dāng)多個事務(wù)方法相互調(diào)用時，事務(wù)應(yīng)該如何傳播的策略。Spring提供了七種事務(wù)傳播機制：REQUIRED、SUPPORTS、MANDATORY、REQUIRES_NEW、NOT_SUPPORTED、NEVER、NESTED。如果你不了解這些傳播策略的原理，很容易導(dǎo)致事務(wù)失效。

@Service
publicclass TransactionsService {

    @Autowired
    private UserMapper userMapper;

    @Autowired
    private AddressMapper addressMapper;

    @Transactional(propagation = Propagation.REQUIRES_NEW, rollbackFor = Exception.class)
    public void doInsert(User user, Address address) throws Exception {
        // do something
        userMapper.insert(user);
        saveAddress(address);
    }

    @Transactional(propagation = Propagation.REQUIRES_NEW)
    public void saveAddress(Address address) {
        // do something
        addressMapper.insert(address);
    }
}

在上面的例子中，如果用戶插入失敗，不會導(dǎo)致saveAddress()回滾，因為這里使用的傳播機制是REQUIRES_NEW。REQUIRES_NEW的原理是，如果當(dāng)前方法沒有事務(wù)，則創(chuàng)建一個新事務(wù)。如果當(dāng)前方法已經(jīng)有事務(wù)，則掛起當(dāng)前事務(wù)并創(chuàng)建一個新事務(wù)。父事務(wù)會等到當(dāng)前事務(wù)完成后才提交。如果父事務(wù)發(fā)生異常，不會影響子事務(wù)的提交。

解決方案：

將事務(wù)傳播策略改為默認(rèn)值REQUIRED。REQUIRED的原理是，如果當(dāng)前有事務(wù)，則加入該事務(wù)。如果沒有事務(wù)，則創(chuàng)建一個新事務(wù)。父事務(wù)和被調(diào)用的事務(wù)處于同一個事務(wù)中。即使被調(diào)用的事務(wù)捕獲了異常，整個事務(wù)仍然會回滾。

7. 沒有被 Spring 管理

// @Service
public class OrderServiceImpl implements OrderService {
    @Transactional
    public void updateOrder(Order order) {
        // update order
    }
}

如果此時@Service注解被注釋掉，這個類就不會被 Spring 加載為 Bean，那么這個類就不會被 Spring 管理，事務(wù)自然也會失效。

解決方案：

確保每個使用事務(wù)注解的Service都被 Spring 管理。

8. 多線程調(diào)用

@Service
publicclass UserService {

    @Autowired
    private UserMapper userMapper;
    @Autowired
    private RoleService roleService;

    @Transactional
    public void add(UserModel userModel) throws Exception {
        userMapper.insertUser(userModel);
        new Thread(() -> {
            try {
                test();
            } catch (Exception e) {
                roleService.doOtherThing();
            }
        }).start();
    }
}

@Service
publicclass RoleService {

    @Transactional
    public void doOtherThing() {
        try {
            int i = 1 / 0;
            System.out.println("save role table data");
        } catch (Exception e) {
            thrownew RuntimeException();
        }
    }
}

我們可以看到，在事務(wù)方法add中，調(diào)用了事務(wù)方法doOtherThing，但doOtherThing是在另一個線程中被調(diào)用的。

這會導(dǎo)致兩個方法不在同一個線程中，獲取的數(shù)據(jù)庫連接也不同，因此是兩個不同的事務(wù)。如果在doOtherThing方法中拋出異常，add方法是不可能回滾的。

我們所說的同一個事務(wù)，實際上指的是同一個數(shù)據(jù)庫連接。只有在同一個數(shù)據(jù)庫連接下，才能同時提交和回滾。如果在不同的線程中，獲取的數(shù)據(jù)庫連接肯定不同，因此它們是不同的事務(wù)。

解決方案：

這有點像分布式事務(wù)。盡量確保在同一個事務(wù)中處理。