本文详解 junit-jupiter 引擎报 NoClassDefFoundError: SelectorResolver 的典型原因，指出 Maven 依赖版本不兼容（尤其是 junit-platform-* 与 junit-jupiter-* 混用旧版）及 Surefire 插件过时是核心症结，并提供可立即生效的依赖对齐方案与验证步骤。
本文详解 `junit-jupiter` 引擎报 `noclassdeffounderror: selectorresolver` 的典型原因，指出 maven 依赖版本不兼容（尤其是 `junit-platform-*` 与 `junit-jupiter-*` 混用旧版）及 surefire 插件过时是核心症结，并提供可立即生效的依赖对齐方案与验证步骤。
在使用 JUnit 5 进行 Java 单元测试时，开发者常遇到“测试类存在但 Maven/IDE 完全无法识别”的问题——控制台抛出类似 TestEngine with ID 'junit-jupiter' failed to discover tests 的警告，堆栈末尾明确指向 java.lang.NoClassDefFoundError: org/junit/platform/engine/support/discovery/SelectorResolver。该异常并非测试代码有误，而是JUnit 平台层核心类缺失，本质是依赖版本错配导致的类加载失败。
? 根本原因分析
错误堆栈中的 SelectorResolver 类属于 junit-platform-engine 模块（JUnit Platform 的核心发现机制），其路径为 org.junit.platform.engine.support.discovery.*。而你的 pom.xml 中仅声明了 junit-jupiter-api 和 junit-jupiter-engine，却未显式引入 junit-platform-engine 或其聚合模块。更关键的是：
-
junit-jupiter-engine:5.10.0要求junit-platform-engine≥ 1.10.0； - 但你使用的
maven-surefire-plugin:2.22.2（发布于 2019 年）仅支持 JUnit Platform ≤ 1.3.x，与 JUnit 5.10 的平台 API 完全不兼容； - 同时，答案中建议的
junit-platform-suite-engine:1.8.2+junit-jupiter-engine:5.8.2组合虽可临时绕过，但属于降级妥协，非推荐解法。
✅ 正确解决方案（推荐：对齐、升级、精简）
请将 pom.xml 中的测试依赖与插件按以下方式重构：
<!-- ✅ 必须：统一使用 JUnit 5 最新版（截至 2026 年推荐 5.10.3+） -->
<dependency>
<groupId>org.junit.jupiter</groupId>
<artifactId>junit-jupiter</artifactId>
<version>5.10.3</version>
<scope>test</scope>
</dependency>
<!-- ⚠️ 注意：junit-jupiter 已包含 api + engine + params，无需单独声明三者 --><!-- ✅ 必须：升级 Surefire 至兼容 JUnit 5.10+ 的版本 -->
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-surefire-plugin</artifactId>
<version>3.2.5</version> <!-- 支持 JUnit Platform 1.10+ -->
<configuration>
<includes>
<include>**/*Test.java</include>
<include>**/Test*.java</include>
</includes>
</configuration>
</plugin>? 关键说明：
junit-jupiter是官方推荐的 BOM（Bill of Materials）式聚合依赖，自动管理junit-jupiter-api、junit-jupiter-engine、junit-jupiter-params等子模块的严格版本一致性，彻底规避手动声明导致的版本分裂。
? 验证与调试步骤
-
清理并强制更新依赖：
mvn clean dependency:purge-local-repository -DreResolve=false mvn compile test-compile
-
检查实际解析的依赖树：
mvn dependency:tree -Dincludes="org.junit:*"
确保输出中
junit-platform-engine版本 ≥1.10.0，且无多个冲突版本。 -
运行测试并启用 Surefire 调试日志：
mvn test -X | grep -i "discovering\|jupiter\|platform"
观察是否出现
Discovering tests in class ...日志，确认发现阶段已正常启动。
⚠️ 常见陷阱提醒
-
勿混用 JUnit 4 与 JUnit 5 的 Surefire 配置：若项目残留
surefire-junit47，需彻底移除； -
IDE 缓存需刷新：IntelliJ 中执行
File → Reload project，Eclipse 中右键项目 →Maven → Update Project； - Java 版本兼容性：JUnit 5.10+ 要求 Java 8+，但推荐 Java 11+（你当前使用 Java 11 符合要求）；
-
测试类命名规范：确保类名以
Test结尾（如AttestationIdentiteCallParamsTest），或通过 Surefire<includes></includes>显式配置，避免默认扫描规则遗漏。
遵循以上方案后，mvn test 将稳定发现并执行全部 800+ 测试用例，SelectorResolver 类加载失败问题将彻底消失。记住：JUnit 5 的稳定性高度依赖平台层（Platform）与 Jupiter 层（Jupiter）的版本协同，而非单点升级——统一使用 junit-jupiter BOM 依赖，是避免此类“找不到测试”问题的最简、最健壮实践。
