关键是要在 module-info.java 中声明 open module 并显式 requires org.junit.platform.launcher 等核心模块,同时配置 junit-platform.properties 启用并行,并确保 IDE/构建工具启用模块路径运行模式。

要在模块化项目中让 JUnit 5 正确支持并发测试并被 IDE/构建工具识别,关键不是只加 @Test 或配 junit-platform.properties,而是先确保模块系统“认得”JUnit、允许它访问所需内部类,并开放并发所需的反射与服务发现能力。
module-info.java 必须声明的 JUnit 模块依赖
仅靠 requires org.junit.jupiter.api 不够——它只支持写测试,不支持运行并发测试。并发执行由 JUnit Platform 的启动器和配置策略驱动,必须显式引入:
-
核心测试 API:
requires org.junit.jupiter.api; -
平台运行基础:
requires org.junit.platform.commons; -
测试启动能力(关键):
requires org.junit.platform.launcher;(缺此会导致IllegalAccessError) -
并发策略支持(可选但推荐):
requires org.junit.jupiter.engine;(提供ParallelExecutionConfigurationStrategy实现)
若使用 Maven,建议用 JUnit BOM 统一版本,避免模块间版本错位:
开放模块以支持并发测试的反射与服务加载
JUnit 5 并发模式(尤其是 concurrent 类级别)需动态实例化测试类、读取配置、调用扩展。默认模块封装会阻止这些操作。因此,测试模块应声明为 open module:
立即学习“Java免费学习笔记(深入)”;
你是 TypeScript 项目架构专家,专注于脚手架搭建生产就绪的 Node.js 和前端应用。生成包含现代工具链(pnpm、Vite、Next.js)、类型
requires org.junit.jupiter.api;
requires org.junit.platform.commons;
requires org.junit.platform.launcher;
requires org.junit.jupiter.engine;
exports com.example.tests;
}
其中 open module 允许 JVM 在运行时对模块内包进行反射访问(如 Class.getDeclaredConstructor().newInstance()),也使 java.util.ServiceLoader 能加载 ParallelExecutionConfigurationStrategy 实现类。
并发配置文件需放在模块资源路径下
仅写 module-info.java 不足以启用并发——还需在 src/test/resources/junit-platform.properties 中启用并行机制:
junit.jupiter.execution.parallel.mode.default=concurrent
junit.jupiter.execution.parallel.mode.classes.default=concurrent
junit.jupiter.execution.parallel.config.strategy=fix
junit.jupiter.execution.parallel.config.fixed.parallelism=4
注意:该文件必须位于测试模块的 模块路径资源根目录下(即编译后出现在 test-classes/ 根目录),否则 JUnit Platform 启动器无法加载。IntelliJ 或 VS Code 若仍走类路径运行,会导致该文件被忽略。
IDE 和构建工具需启用模块路径运行模式
即使 module-info.java 和配置都正确,IDE 默认仍可能把 JUnit JAR 当作类路径上的“未命名模块”,触发封装错误:
- IntelliJ IDEA:进入 Run → Edit Configurations → Templates → JUnit,勾选 Use classpath of module 并确认模块名正确;在 Build → Java Compiler 中启用 Use '--module-path' and '--add-modules'
-
VS Code:确保已安装 Extension Pack for Java,运行 Java: Refresh Projects,并在 settings.json 中添加:
"java.test.config": {"mode": "module"} -
Maven Surefire:配置插件强制使用模块路径:
org.apache.maven.plugins
maven-surefire-plugin
3.2.5
--module-path ${surefire.module.path} --add-modules ALL-SYSTEM,org.junit.jupiter.api,org.junit.platform.launcher


















