执行mvn test参数化传testng.xml报错testSuiteXmlFiles0 has null value

testSuiteXmlFiles0 has null value报错由两个配置不匹配问题直接导致：

1. maven-surefire-plugin 3.0.0-M4版本接收TestNG suite路径的合法参数名与旧版本、网上零散教程的写法不一致，你使用的-Dsurefire.xmlfiles是无效参数
2. pom.xml内的surefire插件配置未给suiteXmlFiles设置可被命令行覆盖的属性占位，直接传入未被识别的参数时，插件会将suite列表解析为空值抛出错误

1. 调整pom.xml配置 #

首先在pom的<properties>节点添加默认参数值，保证无命令行传参时本地执行不会报错：

<properties>
    <!-- 默认执行的TestNG suite文件，命令行传参可覆盖 -->
    <surefire.suiteXmlFiles>testng_smoke.xml</surefire.suiteXmlFiles>
    <!-- 默认测试环境地址 -->
    <url>http://automationpractice.com/index.php</url>
</properties>

然后修改maven-surefire-plugin的配置段，绑定参数占位，同时配置自定义系统参数透传：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-surefire-plugin</artifactId>
    <version>3.0.0-M4</version>
    <configuration>
        <suiteXmlFiles>
            <!-- 绑定命令行传入的suite参数 -->
            <suiteXmlFile>${surefire.suiteXmlFiles}</suiteXmlFile>
        </suiteXmlFiles>
        <!-- 透传自定义的url等系统参数到测试执行进程 -->
        <systemPropertyVariables>
            <url>${url}</url>
        </systemPropertyVariables>
    </configuration>
</plugin>

2. 使用正确的命令执行 #

3.0.0-M4版本指定suite文件的合法参数名是surefire.suiteXmlFiles，替换你之前的错误参数即可执行成功：

mvn test -Dsurefire.suiteXmlFiles=testng_smoke.xml -Durl=http://automationpractice.com/index.php

如果你的testng.xml文件没有放在项目根目录，需要写完整相对路径，比如src/test/resources/testng_smoke.xml，路径不存在也会触发同类空值报错。

3. Jenkins参数化对接配置 #

后续对接Jenkins时不需要修改现有pom配置，直接做两步配置即可：

• 新增构建参数：参数名设为surefire.suiteXmlFiles，可配置为选项参数，枚举项目下所有TestNG suite文件路径供构建时选择
• 新增构建参数：参数名设为url，可配置为字符串参数，默认值填对应测试环境地址
  构建执行命令直接写为mvn test -Dsurefire.suiteXmlFiles=$surefire.suiteXmlFiles -Durl=$url即可实现完全参数化构建。

• 不要照搬网上旧版本surefire的-DsuiteXmlFile单文件参数写法，3.0.0-M4版本将suite文件按集合类型解析，参数名不匹配就会抛出空值错误
• 所有自定义传入的测试参数（比如你用到的url）都需要在<systemPropertyVariables>节点做绑定，否则surefire fork出的测试进程拿不到命令行传入的参数值
• 如果配置后仍报错，先执行mvn help:effective-pom查看实际生效的surefire配置，确认suiteXmlFile节点的值是否被正确替换

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