Jenkins迁移Github Actions后Maven编译类减少致测试失败排查

核心差异定位 #

目前已明确两个环境的关键行为差异：

• Jenkins构建时，build-helper-maven-plugin会同时添加src/test-integration/groovy和src/test-integration/java作为测试源目录；而Github Actions中仅加载了src/test-integration/java目录
• Github Actions的gmavenplus-plugin因未检测到指定源，跳过了testGenerateStubs步骤，Jenkins则正常执行该操作

这些直接导致Groovy测试类未被编译、对应stub未生成，最终编译类数量从452降至199，出现IntegrationTestDataUtility找不到的编译错误。

排查与修复步骤 #

1. 核对Maven配置文件一致性 #

• 确认Github Actions使用的settings.xml与Jenkins、本地环境的版本是否一致，重点检查是否存在环境专属的profile或属性配置——不同环境的settings可能激活不同profile，导致插件行为差异。
• 检查项目pom.xml中build-helper-maven-plugin的配置，是否存在依赖环境变量/系统属性的条件判断，比如是否仅在特定环境下才添加Groovy源目录。

2. 验证gmavenplus-plugin配置 #

• 查看pom.xml中gmavenplus-plugin的testGenerateStubs目标配置，确保明确指定Groovy测试源目录：

  <plugin>
    <groupId>org.codehaus.gmavenplus</groupId>
    <artifactId>gmavenplus-plugin</artifactId>
    <version>你的插件版本</version>
    <executions>
      <execution>
        <goals>
          <goal>testGenerateStubs</goal>
          <goal>testCompile</goal>
        </goals>
      </execution>
    </executions>
    <configuration>
      <testSources>
        <testSource>
          <directory>src/test-integration/groovy</directory>
          <includes>
            <include>**/*.groovy</include>
          </includes>
        </testSource>
      </testSources>
    </configuration>
  </plugin>
  

• 确认Github Actions构建环境中，gmavenplus-plugin能正确识别Groovy源文件，排除因缺失Groovy SDK、插件版本不兼容导致的跳过逻辑触发。

3. 检查构建环境差异 #

• 对比Jenkins与Github Actions的Maven版本、JDK版本，部分旧版插件可能存在行为差异，比如build-helper-maven-plugin对目录的识别逻辑不同。
• 排查Github Actions工作目录的路径问题，比如是否存在大小写敏感差异（Linux环境路径区分大小写，Windows不区分），导致src/test-integration/groovy目录未被正确识别。

4. 本地复现Github Actions构建场景 #

• 在本地执行与Github Actions完全一致的构建命令：mvn clean deploy -U -B -s 你的github-actions-settings.xml，观察是否复现类数量不足的问题。若能复现，说明问题出在配置文件；若不能，则聚焦Github Actions的环境特殊配置。

总结 #

问题根源是Github Actions构建时未正确加载Groovy测试源目录，且gmavenplus-plugin未生成对应stub。通过核对配置文件、插件设置、环境差异，即可定位并解决问题。

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