在Java中如何搭建单元测试环境_JUnit测试环境配置说明_技术教程

正确方式是仅添加 junit-jupiter 依赖，版本推荐5.10.2，配合 Surefire 3.2.5+ 插件；需避免 JUnit 4 混用，测试类须 public 非 final，方法 public void 且加 @Test；推荐搭配 AssertJ 提升断言可读性。

用 Maven 引入 JUnit 5 的正确依赖组合

JUnit 5 不是单个 jar，而是由 junit-jupiter（测试编写）、junit-platform-launcher（IDE/构建工具调用）和 junit-platform-console（命令行运行）三部分组成。Maven 项目只需声明 junit-jupiter，它会自动拉取必要传递依赖。

在 pom.xml 中添加以下依赖（注意版本号，推荐使用最新稳定版，如 5.10.2）：


    org.junit.jupiter
    junit-jupiter
    5.10.2
    test

不要同时引入 junit:junit:4.x，否则可能触发混合执行、断言行为不一致（比如 assertThrows 在 JUnit 4 下不可用）
若用 IntelliJ IDEA，默认支持 JUnit 5；Eclipse 需确保安装了 JUnit 5 Support 插件（4.13+ 版本已内置）

测试类和方法的命名与注解规范

JUnit 5 不强制要求类名以 Test 结尾或方法名以 test 开头，但 IDE 和构建工具（如 Maven Surefire）默认只扫描满足这些约定的类——这是实际运行失败最常见的原因。

类必须是 public，且不能是 final（否则无法被反射实例化）
测试方法必须是 public void，无参数，且标注 @Test
避免使用 static 方法：JUnit 不会执行静态测试方法
生命周期方法用 @BeforeEach / @AfterEach（替代 JUnit 4 的 @Before / @After），类级用 @BeforeAll / @AfterAll（对应方法必须是 static）

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

class CalculatorTest {
    @Test
    void add_returnsCorrectResult() {
        assertEquals(5, new Calculator().add(2, 3));
    }
}

Maven Surefire 插件配置常见陷阱

默认情况下，Maven 使用 Surefire 插件执行测试，但它对 JUnit 5 的支持取决于插件版本。低于 2.22.0 的版本无法识别 @Test（来自 junit-jupiter），导致 mvn test 显示 “No tests found”。

必须显式配置 Surefire 插件版本，并指定 junit-platform-engine 作为 provider：


    org.apache.maven.plugins
    maven-surefire-plugin
    3.2.5
    
        
            **/*Test.java

不需要额外添加 surefire-junit5-provider：现代 Surefire 已内置支持
如果项目里混用了 TestNG 或 JUnit 4，需通过排除干扰类，否则可能因类加载冲突导致启动失败

断言失败时看不到堆栈或值？检查 `assertj` 或日志配置

原生 assertEquals(expected, actual) 在失败时只打印

两个值的 toString()，对复杂对象（如嵌套 List、自定义 DTO）可读性差。这不是 JUnit 问题，而是断言库能力边界。

推荐搭配 assertj 使用，它提供链式断言和清晰的失败消息：


    org.assertj
    assertj-core
    3.24.2
    test

示例对比：
assertEquals(list1, list2) 失败时只显示 [1,2] != [1,3]
assertThat(list1).isEqualTo(list2) 失败时高亮差异位置：expected: [1, 3] but was: [1, 2]
IDE 控制台编码为 GBK 时，中文断言消息可能乱码——需在运行配置中添加 VM option：-Dfile.encoding=UTF-8

JUnit 5 环境看似简单，真正卡住人的往往不是“怎么配”，而是“为什么没跑起来”：测试类没被扫描到、Surefire 版本太旧、断言库未生效、甚至 IDE 缓存没刷新。动手前先确认 mvn test -X 输出里是否真加载了 JupiterTestEngine，比反复改 pom 更有效。