Java 单元测试怎么使用 @ExtendWith 扩展测试行为-java教程-PHP中文网

@extendwith 是 junit 5 中声明式注册扩展的核心注解，支持在测试类或方法上复用外部行为（如 mock 管理、spring 集成、日志增强等），通过实现 extension 接口并按序调用生命周期方法实现可插拔能力。

java 单元测试怎么使用 @extendwith 扩展测试行为

@ExtendWith 是 JUnit 5 中用于声明式注册扩展（Extension）的核心注解，它让测试类或单个测试方法能复用外部行为（比如资源初始化、Mock 管理、事务控制、日志增强等），而无需侵入业务逻辑代码。

一、基础用法：加载自定义或内置扩展

只需在测试类或方法上添加 @ExtendWith，传入一个或多个实现了 Extension 接口的类：

@ExtendWith(MockitoExtension.class) // 启用 Mockito 支持
@ExtendWith(DatabaseCleanupExtension.class) // 自定义清理扩展
class UserServiceTest {
    @Test
    void shouldCreateUser() {
        // 测试逻辑
    }
}

JUnit 5 会按顺序创建并调用这些扩展的生命周期方法（如 beforeEach、afterEach、beforeAll 等）。

二、常用内置扩展示例

JUnit 5 提供了多个开箱即用的扩展，直接使用即可：

js2java

JavaScript 到 Java 全栈翻译助手，专为前端开发者学习 Java 或快速实现后端业务逻辑而设计。当用户提到以下场景时必须使用此技能： - "帮我把这段 JS 代码转成 Java" - "用 Java 怎么写这个逻辑" - "我习惯用 JS 写，想翻译成 Java" - "教我 Java，我要写后端接...

下载

@ExtendWith(MockitoExtension.class)：自动注入 @Mock、@Spy、@InjectMocks 字段，替代手动 MockitoAnnotations.initMocks(this)
@ExtendWith(SpringExtension.class)：配合 @ContextConfiguration 或 @SpringBootTest，让测试运行在 Spring 容器中（注意：Spring Boot 2.2+ 默认已自动注册，通常无需显式写）
@ExtendWith(DisableOnCIExtension.class)（需自定义）：可封装条件逻辑，例如跳过 CI 环境中的慢测试

三、快速编写一个实用自定义扩展

比如实现一个“测试执行前后打印日志”的简单扩展：

public class LoggingExtension implements TestWatcher, BeforeEachCallback, AfterEachCallback {
    @Override
    public void beforeEach(ExtensionContext context) {
        System.out.println("▶️ 开始测试: " + context.getDisplayName());
    }

    @Override
    public void afterEach(ExtensionContext context) {
        System.out.println("⏹️ 结束测试: " + context.getDisplayName());
    }

    @Override
    public void testFailed(ExtensionContext context, Throwable cause) {
        System.err.println("❌ 失败: " + cause.getMessage());
    }
}

然后在测试中启用：
@ExtendWith(LoggingExtension.class)