GitHub Action运行JUnit5单测报UniqueIdTrackingListener异常如何解决？

该NoSuchMethodError由JUnit Platform组件版本不兼容导致：

• TestPlan.getConfigurationParameters()是JUnit Platform 1.8版本才新增的API
• 项目中引入的junit-platform-launcher版本低于1.8，但GitHub Action环境下maven-surefire-plugin加载的UniqueIdTrackingListener属于高版本JUnit Platform组件，调用了这个不存在的方法，触发类路径冲突
• 本地运行正常是因为本地Maven依赖仲裁结果刚好拉取到版本匹配的组件，而CI环境的依赖仲裁结果触发了版本不匹配问题

方案1：统一锁定JUnit版本（推荐） #

在pom.xml的<dependencyManagement>节点导入JUnit官方BOM，统一所有JUnit 5相关组件的版本，彻底避免版本冲突：

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>org.junit</groupId>
      <artifactId>junit-bom</artifactId>
      <version>5.9.2</version> <!-- 可替换为你需要的稳定版本 -->
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

配置后项目内所有JUnit 5相关依赖不需要单独指定版本，会自动和BOM版本保持一致。

方案2：升级maven-surefire-plugin到匹配版本 #

确保maven-surefire-plugin版本和你使用的JUnit 5版本兼容，比如JUnit 5.9.x对应surefire 3.0.0-M7及以上版本：

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-surefire-plugin</artifactId>
  <version>3.1.2</version>
</plugin>

方案3：临时关闭冲突监听器（应急用） #

如果暂时不想调整版本，可以在surefire配置中关闭触发异常的UniqueIdTrackingListener：

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-surefire-plugin</artifactId>
  <configuration>
    <properties>
      <configurationParameters>
        junit.platform.listeners.uniqueIdTracking.enabled=false
      </configurationParameters>
    </properties>
  </configuration>
</plugin>

内容的提问来源于stack exchange，提问作者Frederic