@Transactional + @Rollback 是最直接有效的回滚方案,Spring Boot 默认不自动回滚测试数据,必须显式启用事务管理才能触发回滚,核心机制是在测试方法执行前开启事务、结束时由@Rollback自动回滚。

@Transactional + @Rollback 是最直接有效的回滚方案
Spring Boot 默认不自动回滚测试数据,必须显式启用事务管理才能触发回滚。核心机制是:在测试方法执行前开启事务,方法结束时(无论成功或异常)由 @Rollback 触发回滚——前提是该方法运行在 Spring 管理的事务上下文中。
常见错误包括:
- 测试类没加
@Transactional,仅加@Rollback无效 - 使用了
Propagation.REQUIRES_NEW,导致回滚作用域被隔离,外层事务无法控制子事务 - 测试方法抛出非
RuntimeException异常(如Exception),而@Rollback默认只对运行时异常生效
推荐写法:
@SpringBootTest
@Transactional
class UserControllerIntegrationTest {
@Test
@Rollback // 默认 true,可省略
void shouldInsertAndRollback() {
userRepository.save(new User("test", "test@example.com"));
assertThat(userRepository.count()).isEqualTo(1L);
// 方法结束,事务自动回滚
}
}
@DataJpaTest 自带事务与回滚,适合纯数据层验证
@DataJpaTest 是轻量级切片测试注解,它只加载 JPA 相关 Bean 和内存数据库(如 H2),并默认启用事务、自动回滚,无需手动加 @Transactional 或 @Rollback。
适用场景明确:
- 只测
JpaRepository方法(save、findById、findAll等) - 验证自定义 JPQL 或
@Query是否正确 - 不想启动完整 Web 层或 Service Bean
注意点:
- 它会禁用所有非 JPA 的自动配置,
@Autowired UserService会失败 - 若需自定义数据源(如 PostgreSQL 测试),要用
@AutoConfigureTestDatabase(replace = AutoConfigureTestDatabase.Replace.NONE) - 回滚发生在每个
@Test方法末尾,不是整个类
@SpringBootTest(webEnvironment = WebEnvironment.RANDOM_PORT) 下回滚失效的典型原因
当用 @SpringBootTest 启动真实 Web 容器(如 RANDOM_PORT)时,Controller 层调用可能绕过 Spring 事务代理,导致 @Transactional 失效——尤其是通过 HTTP 请求发起的调用(比如用 RestTemplate 或 WebTestClient 调后端接口)。
根本问题在于:事务边界只覆盖当前线程内 Spring Bean 的方法调用;HTTP 请求会进入新线程,脱离原事务上下文。
可行解法:
- 改用
@WebMvcTest+@MockBean测 Controller,不走真实 DB(无回滚需求) - 坚持用
RANDOM_PORT时,在测试方法内直接调用 Service 层,而非发 HTTP 请求 - 若必须走 HTTP,确保目标 Service 方法有
@Transactional且被 Spring 代理(非 this. 调用)
事务传播行为写错会导致回滚静默失败
@Transactional(propagation = Propagation.REQUIRES_NEW) 是高频陷阱:它会挂起当前事务、新建一个独立事务,而 @Rollback 只作用于被标注方法所在的事务——也就是那个新事务。一旦该方法结束,新事务回滚,但原事务(如果存在)仍处于活跃状态,不会受控回滚。
更隐蔽的问题是:测试里嵌套调用多个 @Transactional 方法,若传播类型混用,回滚逻辑就不可预测。
安全做法:
- 测试方法上统一用默认传播行为(
REQUIRED) - 避免在测试中主动调用含
REQUIRES_NEW的业务方法 - 用
@Transactional(noRollbackFor = CustomCheckedException.class)显式控制哪些异常不触发回滚
事务是否真正生效,最简单的验证方式是:在测试方法末尾加一行 assertThat(jdbcTemplate.queryForObject("SELECT COUNT(*) FROM user", Long.class)).isEqualTo(0L); ——别只信日志或测试通过,得看 DB 真实状态。










