项目类路径未找到RetryListener，CI流水线执行失败求助

问题描述 #

CI/CD流水线运行时抛出错误，提示监听器com.mycompany.test.util.RetryListener未在项目类路径中找到。该监听器在本地开发环境可正常运行，但在流水线执行时失效。

相关配置与代码 #

TestNG XML配置片段

<listeners>
    <listener class-name="com.mycompany.test.util.RetryListener"/>
</listeners>

Java代码片段

package com.mycompany.test.util;

public class RetryListener implements IAnnotationTransformer {
//...
}

说明：IAnnotationTransformer继承自ITestNGListener

错误日志

[2023-05-03T19:33:03.596Z] Listener com.mycompany.test.util.RetryListener was not found in project's classpath
[2023-05-03T19:33:03.596Z] org.apache.maven.surefire.booter.SurefireBooterForkException: There was an error in the forked process
[2023-05-03T19:33:03.596Z] 
[2023-05-03T19:33:03.596Z] Listener com.mycompany.test.util.RetryListener was not found in project's classpath
[2023-05-03T19:33:03.596Z]  at org.apache.maven.plugin.surefire.booterclient.ForkStarter.fork(ForkStarter.java:656)
[2023-05-03T19:33:03.596Z]  at org.apache.maven.plugin.surefire.booterclient.ForkStarter.run(ForkStarter.java:282)
[2023-05-03T19:33:03.596Z]  at org.apache.maven.plugin.surefire.booterclient.ForkStarter.run(ForkStarter.java:245)
[2023-05-03T19:33:03.596Z]  at org.apache.maven.plugin.surefire.AbstractSurefireMojo.executeProvider(AbstractSurefireMojo.java:1183)
[2023-05-03T19:33:03.596Z]  at org.apache.maven.plugin.surefire.AbstractSurefireMojo.executeAfterPreconditionsChecked(AbstractSurefireMojo.java:1011)
[2023-05-03T19:33:03.596Z]  at org.apache.maven.plugin.surefire.AbstractSurefireMojo.execute(AbstractSurefireMojo.java:857)
[2023-05-03T19:33:03.596Z]  at org.apache.maven.plugin.DefaultBuildPluginManager.executeMojo(DefaultBuildPluginManager.java:137)
[2023-05-03T19:33:03.596Z]  at org.apache.maven.lifecycle.internal.MojoExecutor.execute(MojoExecutor.java:210)
[2023-05-03T19:33:03.596Z]  at org.apache.maven.lifecycle.internal.MojoExecutor.execute(MojoExecutor.java:156)
[2023-05-03T19:33:03.596Z]  at org.apache.maven.lifecycle.internal.MojoExecutor.execute(MojoExecutor.java:148)
[2023-05-03T19:33:03.596Z]  at org.apache.maven.lifecycle.internal.LifecycleModuleBuilder.buildProject(LifecycleModuleBuilder.java:117)
[2023-05-03T19:33:03.596Z]  at org.apache.maven.lifecycle.internal.builder.multithreaded.MultiThreadedBuilder$1.call(MultiThreadedBuilder.java:202)
[2023-05-03T19:33:03.596Z]  at org.apache.maven.lifecycle.internal.builder.multithreaded.MultiThreadedBuilder$1.call(MultiThreadedBuilder.java:198)
[2023-05-03T19:33:03.596Z]  at java.util.concurrent.FutureTask.run(FutureTask.java:266)
[2023-05-03T19:33:03.596Z]  at java.util.concurrent.Executors$RunnableAdapter.call(Executors.java:511)
[2023-05-03T19:33:03.596Z]  at java.util.concurrent.FutureTask.run(FutureTask.java:266)
[2023-05-03T19:33:03.596Z]  at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1149)
[2023-05-03T19:33:03.596Z]  at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:624)

[2023-05-03T19:33:03.596Z]  at java.lang.Thread.run(Thread.java:748)
.
.
.
[2023-05-03T19:33:03.597Z]     at java.util.concurrent.ThreadPoolExecutor.runWorker (ThreadPoolExecutor.java:1149)
[2023-05-03T19:33:03.597Z]     at java.util.concurrent.ThreadPoolExecutor$Worker.run (ThreadPoolExecutor.java:624)
[2023-05-03T19:33:03.597Z]     at java.lang.Thread.run (Thread.java:748)
[2023-05-03T19:33:03.597Z] Caused by: org.apache.maven.surefire.booter.SurefireBooterForkException: There was an error in the forked process

排查与解决步骤 #

1. 检查Maven编译阶段是否执行 #

本地环境会自动编译源码，但流水线可能跳过编译步骤，或监听器所在目录未被Maven识别：

• 确认RetryListener所在目录属于Maven默认源码目录（src/main/java或src/test/java），若自定义目录需在pom.xml中配置<sourceDirectory>或<testSourceDirectory>。
• 流水线执行命令改为mvn clean compile test，确保先完成编译再执行测试。

2. 验证Surefire插件类路径配置 #

Maven Surefire插件在fork进程时可能未包含编译后的class文件：

• 检查pom.xml中Surefire插件配置，避免手动排除项目自身编译产物：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-surefire-plugin</artifactId>
    <version>你的插件版本</version>
    <configuration>
        <classpathDependencyExcludes>
            <!-- 不要排除target/classes或target/test-classes下的文件 -->
        </classpathDependencyExcludes>
    </configuration>
</plugin>

• 临时禁用fork模式排查问题（不推荐长期使用）：

<configuration>
    <forkCount>0</forkCount>
</configuration>

若禁用后正常，说明fork进程的类路径配置存在问题。

3. 确认测试类的编译与加载 #

如果监听器位于src/test/java下：

• 检查流水线中target/test-classes目录是否存在com/mycompany/test/util/RetryListener.class文件，确保测试类被正确编译。

4. 清理流水线缓存 #

部分CI工具会缓存Maven构建产物，导致旧文件未更新：

• 在流水线命令中添加mvn clean，清理旧构建产物后重新编译测试。

5. 检查类名与包名大小写 #

流水线环境（如Linux）是大小写敏感的文件系统，确认代码中的包名、类名与实际文件路径大小写完全一致，避免因大小写不匹配导致类找不到。

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