如何在TestNG测试报告中重命名测试方法名称？

当然可以实现，TestNG本身没有提供现成的@Rename注解，但有几种实用方法能在测试报告中替换方法名，以下是具体方案：

TestNG的@Test注解自带description参数，大部分测试报告工具（包括TestNG原生报告、ExtentReports等）都会优先展示这个描述，或作为方法名的补充。直接给@Test添加该参数即可：

import org.testng.Assert;
import org.testng.annotations.Test;

public class TestClass {
    
    @Test(groups="testng", description = "意图识别功能验证")
    public void testIntentRecognition() {
        System.out.println("test1 from group1");
        Assert.assertTrue(true, "success");
    }

    @Test(groups="testng", description = "文档检索功能验证")
    public void testDocumentRetrieval() {
        System.out.println("test1 from group1");
        Assert.assertTrue(true, "success");
    }
}

生成报告后，会显示你设置的描述文本，替代或补充原来的方法名。

如果需要更定制化的控制，比如不想依赖description，可以自定义注解，再通过TestNG监听器替换报告中的方法名：

步骤1：自定义@TestCaseName注解 #

import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD)
public @interface TestCaseName {
    String value();
}

步骤2：实现TestNG监听器，拦截测试方法名称 #

编写ITestListener实现类，在测试方法启动时，获取自定义注解的值并替换方法名：

import org.testng.ITestContext;
import org.testng.ITestListener;
import org.testng.ITestResult;
import java.lang.reflect.Method;

public class TestNameListener implements ITestListener {
    @Override
    public void onTestStart(ITestResult result) {
        Method method = result.getMethod().getConstructorOrMethod().getMethod();
        TestCaseName testCaseName = method.getAnnotation(TestCaseName.class);
        if (testCaseName != null) {
            result.getMethod().setMethodName(testCaseName.value());
        }
    }

    // 其他监听器方法留空即可
    @Override public void onTestSuccess(ITestResult result) {}
    @Override public void onTestFailure(ITestResult result) {}
    @Override public void onTestSkipped(ITestResult result) {}
    @Override public void onTestFailedButWithinSuccessPercentage(ITestResult result) {}
    @Override public void onStart(ITestContext context) {}
    @Override public void onFinish(ITestContext context) {}
}

步骤3：注册监听器 #

方式1：测试类上添加@Listeners注解 #

import org.testng.Assert;
import org.testng.annotations.Listeners;
import org.testng.annotations.Test;

@Listeners(TestNameListener.class)
public class TestClass {
    
    @TestCaseName("意图识别测试")
    @Test(groups="testng")
    public void testIntentRecognition() {
        System.out.println("test1 from group1");
        Assert.assertTrue(true, "success");
    }

    @TestCaseName("文档检索测试")
    @Test(groups="testng")
    public void testDocumentRetrieval() {
        System.out.println("test1 from group1");
        Assert.assertTrue(true, "success");
    }
}

方式2：在testng.xml中配置 #

<suite name="TestSuite">
    <listeners>
        <listener class-name="com.yourpackage.TestNameListener"/>
    </listeners>
    <test name="Test">
        <groups>
            <run>
                <include name="testng"/>
            </run>
        </groups>
        <classes>
            <class name="com.yourpackage.TestClass"/>
        </classes>
    </test>
</suite>

这样生成的报告中，测试方法名会被替换为你设置的自定义名称。

如果需要完全控制报告样式，可以修改TestNG默认报告模板：

1. 从TestNG的jar包中导出默认模板（如emailable-report.html）
2. 复制模板到项目资源目录，修改模板逻辑，比如读取自定义注解值替换方法名
3. 在testng.xml中配置使用自定义模板：

<suite name="TestSuite">
    <parameter name="testng.report.template" value="path/to/your/custom-template.html"/>
    <test name="Test">
        <!-- 测试配置 -->
    </test>
</suite>

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