TestNG执行报告显示用例通过数但Extent报告通过数为零问题咨询

核心根因 #

该问题是ExtentReports 5.x版本对接TestNG时的典型适配问题，核心为TestNG事件回调与Extent实例状态同步异常，常见触发场景如下：

• 漏写或错误调用extent.flush()方法，用例执行状态未持久化到报告统计模块
• 沿用旧版本适配代码，TestNG的ITestResult成功状态未正确映射到Extent的用例状态枚举
• 并行执行测试时ExtentTest实例未做线程隔离，多线程状态互相覆盖
• TestNG监听器仅实现失败、跳过用例的状态同步逻辑，漏写成功用例的回调处理

修复步骤 #

1. 补全成功用例的状态同步逻辑 #

TestNG监听器的onTestSuccess回调必须正确调用ExtentTest的pass方法更新状态：

@Override
public void onTestSuccess(ITestResult result) {
    // 获取当前用例对应的ExtentTest实例，调用pass方法标记成功
    extentTest.pass("测试用例执行通过");
}

Extent 5.x不推荐使用旧版本的log(Status.PASS, xxx)写法，直接调用pass()/fail()等状态方法即可自动更新统计计数

2. 修正flush方法调用时机 #

必须在测试套件执行结束的onFinish回调中全局调用一次flush方法，确保所有用例状态被汇总到报告：

@Override
public void onFinish(ISuite suite) {
    extent.flush();
}

不要在单条用例结束的回调中调用flush，避免统计状态被覆盖。

3. 并行执行场景添加线程隔离 #

如果开启了TestNG并行执行，必须使用ThreadLocal存储每个线程对应的ExtentTest实例，避免多线程状态冲突：

// 全局声明ThreadLocal存储ExtentTest实例
private static ThreadLocal<ExtentTest> extentTestThreadLocal = new ThreadLocal<>();

@Override
public void onTestStart(ITestResult result) {
    ExtentTest test = extent.createTest(result.getMethod().getMethodName());
    extentTestThreadLocal.set(test);
}

// 其他回调中通过get方法获取当前线程的用例实例
@Override
public void onTestSuccess(ITestResult result) {
    extentTestThreadLocal.get().pass("执行通过");
}

4. 排查依赖冲突 #

检查项目依赖树，排除旧版本ExtentReports相关依赖，确保仅引入5.0.9版本的Extent组件，避免多版本类加载导致的状态异常。

验证方案 #

修复后执行1条单测用例，查看Extent报告的通过计数是否为1，即可确认问题是否解决。

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