如何测试@Transactional注解是否按预期生效？含包私有方法场景

当然可以编写测试来验证包私有方法上的@Transactional注解未生效的场景，集成测试（INT）是最直接的方式，因为需要依赖Spring上下文和数据库来验证事务行为。以下是具体的实现思路和代码示例：

核心测试思路 #

Spring默认的事务代理机制（无论是JDK动态代理还是CGLIB）只会对public方法应用事务增强，包私有（package-private）方法上的@Transactional注解不会被拦截，因此会出现事务不生效、异常时不回滚的情况。测试围绕两个核心点展开：

1. 验证方法执行时未开启事务
2. 验证方法抛出异常时数据未回滚

测试实现步骤 #

1. 被测代码示例 #

假设你有一个Spring管理的服务类，其中包含包私有事务方法：

package com.example.demo.service;

import com.example.demo.entity.User;
import com.example.demo.repository.UserRepository;
import org.springframework.stereotype.Service;
import org.springframework.transaction.annotation.Transactional;

@Service
public class UserService { // 类必须是public才能被Spring扫描管理
    private final UserRepository userRepository;

    public UserService(UserRepository userRepository) {
        this.userRepository = userRepository;
    }

    // 包私有方法，添加@Transactional但不会生效
    @Transactional
    void addUser(String username) {
        userRepository.save(new User(username));
        if ("rollback-test".equals(username)) {
            throw new RuntimeException("触发异常，测试回滚");
        }
    }
}

2. 集成测试代码 #

将测试类放在同一个包下，以访问包私有方法，使用@SpringBootTest加载完整上下文：

package com.example.demo.service;

import com.example.demo.repository.UserRepository;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.transaction.support.TransactionSynchronizationManager;

import static org.junit.jupiter.api.Assertions.*;

@SpringBootTest
class UserServiceTest {

    @Autowired
    private UserService userService;

    @Autowired
    private UserRepository userRepository;

    // 验证事务未开启
    @Test
    void testTransactionNotActiveOnPackagePrivateMethod() {
        // 调用方法前，当前线程无活跃事务
        assertFalse(TransactionSynchronizationManager.isActualTransactionActive());

        // 调用包私有事务方法
        userService.addUser("normal-user");

        // 调用后仍无活跃事务（说明方法执行全程未开启事务）
        assertFalse(TransactionSynchronizationManager.isActualTransactionActive());

        // 验证数据已直接写入数据库（无事务时JDBC默认自动提交）
        assertTrue(userRepository.existsByUsername("normal-user"));
    }

    // 验证异常时不回滚
    @Test
    void testNoRollbackOnException() {
        String testUsername = "rollback-test";

        // 调用方法，预期抛出异常
        assertThrows(RuntimeException.class, () -> userService.addUser(testUsername));

        // 验证数据仍存在于数据库，说明未执行回滚
        assertTrue(userRepository.existsByUsername(testUsername));
    }
}

关键知识点说明 #

• TransactionSynchronizationManager.isActualTransactionActive()：Spring提供的工具方法，可直接检查当前线程是否有活跃的事务上下文，是验证事务是否开启的核心依据。
• 包私有方法的访问：测试类必须与被测类处于同一包下，才能直接调用包私有方法；如果无法同包，也可通过反射调用，但同包更简洁。
• 数据库自动提交：无事务时，JDBC默认会自动提交每个SQL语句，因此数据会直接写入数据库，这也是验证事务未生效的直观表现。

内容的提问来源于stack exchange，提问作者Reddi