Jenkins运行Maven TestNG任务报错Suite文件不是有效文件如何解决

问题根因 #

你的报错核心是Jenkins运行时找不到指定的TestNG套件文件，由两个配置错误共同导致：

1. 路径使用错误：你指定的/framework/TestSuites/AutomatedEmailTests.xml是根目录绝对路径，而Jenkins任务拉取的代码默认存放在/var/jenkins_home/workspace/[你的任务名]目录下，根目录下根本不存在/framework这个路径，本地运行正常是因为你本地的路径刚好匹配。
2. 参数名不匹配：你的pom.xml中maven-surefire-plugin配置的是读取自定义变量${SuiteXmlFile}，但你排查时传的是surefire原生参数-Dsurefire.suiteXmlFiles，参数无法被正确识别。

解决方案 #

方案1：使用相对路径（推荐） #

直接修改Jenkins任务的Maven运行目标为：

test -DSuiteXmlFile=src/TestSuites/AutomatedEmailTests.xml

该路径相对于Jenkins任务执行的根工作目录，无需硬编码全路径，适配性更强。

方案2：使用Jenkins内置变量拼接全路径 #

如果需要指定绝对路径，使用Jenkins内置的${WORKSPACE}变量（自动指向当前任务的工作目录）拼接路径：

test -DSuiteXmlFile=${WORKSPACE}/framework/src/TestSuites/AutomatedEmailTests.xml

可选优化 #

• 你当前使用的maven-surefire-plugin 3.0.0-M3是测试版，存在多个已知的路径解析bug，可以升级到3.2.2正式稳定版避免兼容性问题。
• 排查路径问题时，可以在Jenkins任务中新增一步Shell执行步骤，运行pwd && ls -R，执行一次任务查看输出即可确认代码拉取后的实际目录结构，避免路径写错。

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