求助：TestNG Suite运行正常，Maven Surefire插件执行测试报错

嘿，我之前也碰到过几乎一模一样的情况——用IAnnotationTransformer给TestNG的@Test方法传HashMap参数，直接跑TestNG Suite没问题，一用Maven的surefire插件就报错。结合我踩过的坑，给你梳理下可能的原因和解决办法：

问题回顾 #

你的测试方法大概是这样的：

@Test(priority = 1, description = "TC_Folder_DocumentTab_Add")
public void TC_Folder_DocumentTab_Add(HashMap<String, String> data) throws Exception {
    // 你的测试逻辑...
}

通过IAnnotationTransformer注入参数后，TestNG直接跑testng.xml正常，但用maven-surefire-plugin:2.21.0执行就失败。

可能的原因&解决步骤 #

1. 先把Surefire插件版本升上去 #

Surefire 2.21.0真的太老了（2018年的版本），对TestNG的参数注入、监听器加载这些特性支持得不够完善。我当初把插件升到3.x的稳定版后，大部分问题直接就消失了。

修改pom.xml里的插件配置：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-surefire-plugin</artifactId>
    <version>3.2.2</version> <!-- 用最新的稳定版就好 -->
    <configuration>
        <!-- 如果你的测试是用testng.xml管理的，记得指定路径 -->
        <suiteXmlFiles>
            <suiteXmlFile>testng.xml</suiteXmlFile>
        </suiteXmlFiles>
        <!-- 关键：显式注册你的IAnnotationTransformer实现类 -->
        <properties>
            <property>
                <name>listener</name>
                <value>com.yourpackage.YourTransformerClass</value>
            </property>
        </properties>
    </configuration>
</plugin>

2. 确保监听器被正确注册 #

有时候TestNG直接运行时能自动扫到监听器，但Maven Surefire不会，所以必须显式配置。除了上面在Surefire里加配置，你也可以直接在testng.xml里注册监听器，这样两种运行方式都能生效：

<suite name="YourTestSuite">
    <listeners>
        <listener class-name="com.yourpackage.YourTransformerClass"/>
    </listeners>
    <!-- 你的测试类/方法配置 -->
</suite>

3. 检查TestNG和Surefire的版本兼容性 #

老版本的TestNG和新版本Surefire（或者反过来）可能会有兼容问题。比如Surefire 3.x建议搭配TestNG 7.x版本。你可以把TestNG的依赖也更新下：

<dependency>
    <groupId>org.testng</groupId>
    <artifactId>testng</artifactId>
    <version>7.8.0</version> <!-- 这个版本和Surefire 3.x适配得很好 -->
    <scope>test</scope>
</dependency>

4. 确认你的参数注入逻辑没毛病 #

最后再检查下IAnnotationTransformer的实现，确保正确设置了数据提供者，而且数据提供者返回的格式是对的。比如你的Transformer类应该是这样的：

public class YourTransformerClass implements IAnnotationTransformer {
    @Override
    public void transform(ITestAnnotation annotation, Class<?> testClass, Constructor<?> testConstructor, Method testMethod) {
        // 给测试方法绑定数据提供者
        annotation.setDataProviderClass(YourDataProvider.class);
        annotation.setDataProvider("testDataProvider");
    }
}

对应的DataProvider要返回二维数组，每个元素是测试方法的参数数组（这里就是包含HashMap的数组）：

public class YourDataProvider {
    @DataProvider(name = "testDataProvider")
    public static Object[][] provideTestData() {
        HashMap<String, String> testData = new HashMap<>();
        testData.put("key1", "value1");
        testData.put("key2", "value2");
        return new Object[][]{{testData}};
    }
}

最后验证下 #

先清理下Maven缓存：mvn clean，然后运行测试：mvn test。如果还是有问题，就用mvn test -X看详细日志，里面会有具体的错误信息（比如类找不到、依赖冲突），再针对性解决。

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