在 java 单元测试中引入 junit 5 依赖,需要在构建工具(如 maven 或 gradle)中添加 junit-jupiter 引擎坐标。对于 maven 项目,需在 pom.xml 的 节点下添加 org.junit.jupiter:junit-jupiter:5.10.0;对于 gradle 项目,需在 build.gradle 中使用 testimplementation 'org.junit.jupiter:junit-jupiter:5.10.0'。配置完成后,确保测试运行器(如 surefire 或 junit platform)版本支持 junit 5,即可使用 @test、@beforeeach 等注解编写测试用例。

Maven 项目中如何配置 JUnit 5 依赖与插件
在 Maven 项目中引入 JUnit 5 需要同时处理依赖和插件两个部分。依赖方面,直接引入 junit-jupiter 即可获取所有核心 API 和引擎实现。插件方面,Maven Surefire Plugin 必须升级到 2.22.0 或更高版本才能识别 JUnit Platform。如果使用的是较旧的 Spring Boot 父工程,它可能已经管理了这些版本,但显式声明可以确保一致性。以下是一个标准的 Maven 配置示例,展示了如何定义依赖和配置插件以运行 JUnit 5 测试。
<?xml version="1.0" encoding="UTF-8"?><project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemalocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"><modelversion>4.0.0</modelversion><groupid>com.example</groupid><artifactid>junit5-demo</artifactid><version>1.0-SNAPSHOT</version><properties><maven.compiler.source>17</maven.compiler.source><maven.compiler.target>17</maven.compiler.target><junit.version>5.10.0</junit.version><properties><dependencies><dependency><groupid>org.junit.jupiter</groupid><artifactid>junit-jupiter</artifactid><version>${junit.version}</version><scope>test</scope></dependency></dependencies><build><plugins><plugin><groupid>org.apache.maven.plugins</groupid><artifactid>maven-surefire-plugin</artifactid><version>3.1.2</version></plugin></plugins></build></properties></properties></project>
上述配置中,junit-jupiter 是聚合依赖,包含了 junit-jupiter-api、junit-jupiter-engine 和 junit-jupiter-params。这意味着你不需要单独引入这三个子模块。Maven Surefire Plugin 3.1.2 版本完全支持 JUnit Platform,能够自动发现并运行带有 @Test 注解的方法。当执行 mvn test 时,插件会启动 JUnit Platform,加载引擎并执行测试类。

Gradle 项目中如何配置 JUnit 5 依赖
在 Gradle 项目中引入 JUnit 5 相对更简洁,因为 Gradle 原生支持 JUnit Platform。你只需要在 build.gradle 文件中添加测试依赖即可。Gradle 会自动处理 JUnit Platform 的运行逻辑,无需额外配置插件来适配旧版 JUnit 4 的行为。以下是一个典型的 Gradle 配置示例,展示了如何引入 JUnit 5 并配置测试任务。
FilePond 是一个 JavaScript 文件上传库,支持通过拖拽、粘贴和 API 方式处理文件、目录、URL 和 Data URI。它包含内置的图像优化功能、异步分块上传功能,并提供了适用于 React、Vue、Angular 和 Svelte 的适配器。
plugins {
id 'java'
}
group = 'com.example'
version = '1.0-SNAPSHOT'
repositories {
mavenCentral()
}
dependencies {
testImplementation platform('org.junit:junit-bom:5.10.0')
testImplementation 'org.junit.jupiter:junit-jupiter'
}
test {
useJUnitPlatform()
testLogging {
events 'passed', 'skipped', 'failed'
}
}
在这个配置中,platform('org.junit:junit-bom:5.10.0') 引入了 BOM(Bill of Materials),这确保了所有 JUnit 5 相关依赖的版本一致性,避免版本冲突。随后,testImplementation 'org.junit.jupiter:junit-jupiter' 实际引入了所需的库。在 test 任务块中,useJUnitPlatform() 是关键配置,它告诉 Gradle 使用 JUnit Platform 来运行测试,而不是默认的 JUnit 4 运行器。如果不加这一行,Gradle 可能会尝试运行 JUnit 4 测试,导致 JUnit 5 测试不被发现。日志配置部分可选,但有助于在控制台看到详细的测试结果。

JUnit 5 中 @Test 注解的默认行为与超时设置
在 JUnit 5 中,@Test 注解不仅用于标记测试方法,还包含了一些默认行为配置。例如,默认情况下,测试方法中的断言失败会立即抛出 AssertionFailedError 并终止当前测试方法的执行。此外,JUnit 5 允许通过 timeout 属性为单个测试方法设置超时时间,单位为毫秒。如果测试方法执行时间超过设定值,将自动标记为失败。这种机制比 JUnit 4 中的 @Rule 或 @ClassRule 更加直观和灵活。开发者可以在需要验证长时间运行的操作或防止死锁时使用此功能。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










