执行mvn test时TestNG测试用例不运行仅JUnit运行的问题排查

一、Maven Surefire插件配置校验 #

• 确认suiteXmlFiles路径正确性：如果testng.xml放在src/test/resources目录下，配置路径必须写全src/test/resources/testng.xml，仅写testng.xml会导致插件找不到文件。
• 明确指定TestNG Provider：Surefire插件默认优先适配JUnit，需在插件依赖中添加TestNG适配模块，确保触发TestNG执行逻辑：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-surefire-plugin</artifactId>
    <version>3.0.0-M7</version>
    <dependencies>
        <dependency>
            <groupId>org.apache.maven.surefire</groupId>
            <artifactId>surefire-testng</artifactId>
            <version>3.0.0-M7</version>
        </dependency>
    </dependencies>
    <configuration>
        <suiteXmlFiles>
            <suiteXmlFile>src/test/resources/testng.xml</suiteXmlFile>
        </suiteXmlFiles>
    </configuration>
</plugin>

• 检查includes/excludes规则：确保没有配置类似<exclude>**/*TestNG*</exclude>的规则排除TestNG测试类；若使用<include>**/*Test.java</include>，需保证TestNG测试类命名符合该规则。

二、TestNG依赖冲突排查 #

• 执行mvn dependency:tree查看依赖树，确认是否存在多版本TestNG依赖，或TestNG依赖被其他依赖间接覆盖。若有冲突，可通过<dependencyManagement>锁定TestNG版本：

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.testng</groupId>
            <artifactId>testng</artifactId>
            <version>7.7.1</version>
            <scope>test</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

• 确保TestNG依赖的scope为test（测试用例场景），且依赖坐标无拼写错误。

三、TestNG测试用例与配置文件校验 #

• 检查注解包路径：TestNG测试类中的@Test注解必须来自org.testng.annotations.Test，若误导入JUnit的org.junit.Test，该用例只会被JUnit识别，TestNG不会执行。
• 校验testng.xml配置：确认<test>标签下的<classes>或<packages>指定了正确的TestNG测试类/包路径，无拼写错误；同时确保DTD声明正确（<!DOCTYPE suite SYSTEM "https://testng.org/testng-1.0.dtd">），避免配置文件解析失败。
• 检查测试类构造函数：TestNG测试类必须提供无参默认构造函数，若仅存在带参构造函数，TestNG无法实例化类，会跳过执行。

四、Maven执行环境清理 #

• 执行mvn clean test清理旧编译产物后重新测试，避免target目录下的缓存文件影响执行逻辑。
• 确认未使用自定义Maven Profile：若启动命令加了-P参数指定profile，需检查该profile下的Surefire配置是否包含TestNG相关配置。

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