Jenkins构建项目遇TestNG编译错误（已配置pom依赖）

问题现象 #

构建flipkart-automation项目时出现TestNG相关包找不到的编译错误：

[ERROR] COMPILATION ERROR : 
[INFO] -------------------------------------------------------------
[ERROR] /C:/ProgramData/Jenkins/.jenkins/workspace/flipkart-automation/src/main/java/com/flipkart/FlipkartAutomation.java:[7,30] package org.testng.annotations does not exist
[ERROR] /C:/ProgramData/Jenkins/.jenkins/workspace/flipkart-automation/src/main/java/com/flipkart/FlipkartAutomation.java:[8,30] package org.testng.annotations does not exist
[ERROR] /C:/ProgramData/Jenkins/.jenkins/workspace/flipkart-automation/src/main/java/com/flipkart/FlipkartAutomation.java:[12,6] cannot find symbol
  symbol:   class BeforeMethod
  location: class com.flipkart.FlipkartAutomation
[ERROR] /C:/ProgramData/Jenkins/.jenkins/workspace/flipkart-automation/src/main/java/com/flipkart/FlipkartAutomation.java:[19,6] cannot find symbol
  symbol:   class AfterMethod
  location: class com.flipkart.FlipkartAutomation

排查与解决步骤 #

1. 检查TestNG依赖的scope配置 #

确认pom.xml中TestNG依赖的scope是否正确。如果设置为test，main目录下的代码无法访问该依赖，因为test scope仅对src/test/java目录生效。
正确的依赖配置示例：

<dependency>
    <groupId>org.testng</groupId>
    <artifactId>testng</artifactId>
    <version>7.8.0</version>
    <!-- 若main目录需要使用TestNG，不要设置scope为test -->
    <!-- <scope>test</scope> -->
</dependency>

2. 清理Jenkins本地仓库缓存 #

Jenkins可能缓存了损坏或未下载完整的依赖包，执行以下操作：

• 登录Jenkins服务器，找到本地Maven仓库路径（默认是C:\Users\[Jenkins用户]\.m2\repository或C:\ProgramData\Jenkins\.m2\repository）
• 删除org/testng目录下的所有内容
• 重新触发项目构建，让Maven重新下载TestNG依赖

3. 确认Jenkins构建任务的Maven配置 #

• 检查Jenkins构建任务中是否指定了正确的Maven安装路径，确保使用的Maven环境与本地开发环境一致
• 构建命令是否包含clean install，确保每次构建都清理旧的编译产物并重新下载依赖：

  mvn clean install
  

4. 检查代码目录结构合理性 #

TestNG注解通常用于测试代码，建议将包含BeforeMethod、AfterMethod的代码移至src/test/java目录下，而非src/main/java。如果必须在main目录使用，确保依赖scope正确。

5. 验证pom.xml的依赖完整性 #

确认pom.xml中是否正确引入了TestNG，没有拼写错误（groupId、artifactId、version是否正确），可对比Maven中央仓库的标准配置。

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