@beforeeach 和 @aftereach 是 junit 5 中管理单个测试方法生命周期的注解,分别在每个测试前准备和测试后清理,确保测试隔离;二者必须是非静态、无返回值的方法,适用于实例级初始化与清理,不适用于全局资源操作。

@BeforeEach 和 @AfterEach 是 JUnit 5 中用于管理单个测试方法生命周期的核心注解,它们帮你自动完成「每次测试前准备」和「每次测试后清理」,确保每个测试用例彼此隔离、互不干扰。
@BeforeEach:每次测试前执行一次
这个方法会在每个 @Test、@RepeatedTest、@ParameterizedTest 或 @TestFactory 方法运行前被调用。
适合做:对象实例化、模拟数据构造、临时文件创建、数据库连接初始化(非全局)等。
- 方法必须是非静态的(不能加
static) - 无参数或可接受
TestInfo、RepetitionInfo等上下文参数 - 可以抛出异常,若抛出则对应测试会被标记为失败
@BeforeEach
void setUp() {
calculator = new Calculator(); // 每次测试都用新实例
testData = new ArrayList();
}
常见用法包括:
- 创建新的被测对象实例(避免状态残留)
- 初始化 mock 对象(如 Mockito 的
@Mock配合@BeforeEach中的mockitoAnnotations.initMocks(this)) - 准备测试所需的临时资源(如内存中的 Map、List)
@AfterEach:每次测试后执行一次
这个方法会在对应测试方法执行完毕后立即执行(无论成功、失败或跳过),常用于释放资源、重置状态、验证副作用等。
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- 同样必须是非静态方法
- 不建议在此处做断言(断言应放在
@Test内),但可用于日志记录或清理验证
@AfterEach
void tearDown() {
testData.clear(); // 清空列表,防止影响下一个测试
System.out.println("Cleaned up after test: " + currentTestName);
}
典型场景有:
- 关闭打开的流或连接(如
InputStream.close()) - 清空测试数据库表(配合 H2 或 Testcontainers)
- 重置静态变量或单例状态(谨慎使用)
- 删除临时文件或目录
注意事项与常见陷阱
- ❌ 不能把
@BeforeEach或@AfterEach方法写成static,否则会报错:JUnitException: @BeforeEach method must not be static - ✅ 它们对所有测试类型生效,包括
@RepeatedTest(3)会触发 3 次@BeforeEach+ 3 次@AfterEach - ⚠️ 如果
@BeforeEach抛异常,对应测试不会执行;如果@AfterEach抛异常,会影响当前测试结果(可能标记为失败),但不会中断其他测试 - ? 执行顺序固定:
@BeforeAll→@BeforeEach→@Test→@AfterEach→@AfterAll
和 @BeforeAll / @AfterAll 的区别
| 注解 | 执行时机 | 是否静态 | 典型用途 |
|---|---|---|---|
@BeforeEach |
每个测试方法前 | 否 | 实例级初始化(如 new 对象、清空集合) |
@AfterEach |
每个测试方法后 | 否 | 实例级清理(如 close、clear、reset) |
@BeforeAll |
整个类所有测试前 | 是 | 一次性开销大的操作(如启动嵌入式 DB、加载配置) |
@AfterAll |
整个类所有测试后 | 是 | 全局资源释放(如关闭线程池、停掉服务) |
比如连接数据库时:
-
@BeforeAll建立共享连接池(一次) -
@BeforeEach开启事务并获取新Connection(每个测试一份) -
@AfterEach回滚事务并归还连接(每个测试完就清理) -
@AfterAll关闭连接池(最后统一收尾)
不复杂但容易忽略细节。










