当前位置：首页 > 文章列表 > 文章 > java教程 > Java配置JUnit单元测试环境教程

Java配置JUnit单元测试环境教程

2026-01-14 10:18:44 0浏览收藏

从现在开始，我们要努力学习啦！今天我给大家带来《Java如何配置JUnit单元测试环境》，感兴趣的朋友请继续看下去吧！下文中的内容我们主要会涉及到等等知识点，如果在阅读本文过程中有遇到不清楚的地方，欢迎留言呀！我们一起讨论，一起学习！

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

在Java中如何搭建单元测试环境_JUnit测试环境配置说明

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

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

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

<dependency>
    <groupId>org.junit.jupiter</groupId>
    <artifactId>junit-jupiter</artifactId>
    <version>5.10.2</version>
    <scope>test</scope>
</dependency>

不要同时引入 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：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-surefire-plugin</artifactId>
    <version>3.2.5</version>
    <configuration>
        <includes>
            <include>**/*Test.java</include>
        </includes>
    </configuration>
</plugin>

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

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

原生 assertEquals(expected, actual) 在失败时只打印两个值的 toString()，对复杂对象（如嵌套 List、自定义 DTO）可读性差。这不是 JUnit 问题，而是断言库能力边界。

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

<dependency>
    <groupId>org.assertj</groupId>
    <artifactId>assertj-core</artifactId>
    <version>3.24.2</version>
    <scope>test</scope>
</dependency>

示例对比：
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 更有效。

终于介绍完啦！小伙伴们，这篇关于《Java配置JUnit单元测试环境教程》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布文章相关知识，快来关注吧！