如何在JUnit5 HTML测试报告中添加自定义信息？已尝试多方式无果

当然可以解决这个问题！你遇到的TestReporter数据没出现在HTML报告里的情况其实挺普遍——默认的报告生成工具（不管是Gradle的自带插件还是Ant的junitreport）通常不会自动采集TestReporter的输出内容。下面给你几个实用的方案，按需选择：

方案一：利用控制台输出+Gradle日志配置（最快实现） #

这个方法最简单，只需要把自定义信息输出到测试的标准输出/错误流，再让Gradle的测试报告捕获这些内容即可：

1. 在测试中输出自定义信息 #

你可以结合TestReporter和控制台打印，既保留JUnit5的上下文记录，又能让报告捕获到：

import org.junit.jupiter.api.Test;
import org.junit.jupiter.api.TestReporter;

public class PassedTestDemo {
    @Test
    void testWithCustomInfo(TestReporter reporter) {
        // 用TestReporter记录（供其他工具使用）
        reporter.publishEntry("用户ID", "user_12345");
        reporter.publishEntry("测试环境", "staging");
        
        // 输出到控制台，让Gradle报告捕获
        System.out.println("=== 自定义测试信息 ===");
        System.out.println("用户ID: user_12345");
        System.out.println("测试环境: staging");
    }
}

2. 配置Gradle的testLogging #

在build.gradle中开启标准流捕获，这样生成的HTML报告里就能看到这些自定义内容：

test {
    useJUnitPlatform()
    testLogging {
        showStandardStreams = true // 开启标准输出/错误的捕获
        exceptionFormat = 'full'
    }
}

运行测试后，打开HTML报告并点击对应测试的详情，就能看到你输出的自定义信息了。

方案二：自定义JUnit5扩展，优雅添加报告条目 #

如果你不想依赖控制台输出，可以写一个TestWatcher扩展，在测试通过时主动发布自定义报告条目，让支持JUnit5的报告工具（比如Gradle的JUnit Platform报告）读取：

1. 编写自定义扩展类 #

import org.junit.jupiter.api.extension.ExtensionContext;
import org.junit.jupiter.api.extension.TestWatcher;
import java.util.Optional;

public class CustomTestInfoExtension implements TestWatcher {
    @Override
    public void testSuccessful(ExtensionContext context) {
        // 直接添加自定义报告条目
        context.publishReportEntry("测试类型", "功能测试");
        context.publishReportEntry("测试执行人", "QA-Team");
        
        // 也可以从测试方法的注解/参数中获取动态信息
        Optional<String> testMethodName = Optional.ofNullable(context.getTestMethod())
                .map(method -> method.getName());
        testMethodName.ifPresent(name -> context.publishReportEntry("测试方法", name));
    }
}

2. 注册扩展 #

你可以在单个测试类上添加@ExtendWith(CustomTestInfoExtension.class)，或者在Gradle中全局注册，让所有测试都生效：

test {
    useJUnitPlatform {
        extensions {
            include 'com.yourpackage.CustomTestInfoExtension' // 替换成你的扩展类路径
        }
    }
}

注意：Ant的junitreport对这种方式的支持有限，如果你主要用Ant，建议优先选方案一。

方案三：改用Allure报告（追求更丰富的报告体验） #

如果可以更换报告工具，Allure对JUnit5的自定义信息支持非常完善，不仅能展示TestReporter的条目，还能添加步骤、附件等丰富内容：

1. 配置Gradle的Allure插件 #

plugins {
    id 'java'
    id 'io.qameta.allure' version '2.19.0'
}

repositories {
    mavenCentral()
}

dependencies {
    testImplementation 'org.junit.jupiter:junit-jupiter-api:5.9.2'
    testRuntimeOnly 'org.junit.jupiter:junit-jupiter-engine:5.9.2'
    testImplementation 'io.qameta.allure:allure-junit5:2.19.0'
}

test {
    useJUnitPlatform()
}

2. 在测试中添加自定义信息 #

import org.junit.jupiter.api.Test;
import org.junit.jupiter.api.TestReporter;
import io.qameta.allure.Step;

public class AllureTestDemo {
    @Test
    void testWithAllureCustomInfo(TestReporter reporter) {
        // TestReporter的条目会自动出现在Allure报告中
        reporter.publishEntry("订单ID", "order_67890");
        
        // 用Allure的@Step添加步骤信息
        verifyOrderStatus("order_67890");
    }

    @Step("验证订单{0}的状态为已支付")
    void verifyOrderStatus(String orderId) {
        // 测试逻辑
    }
}

运行./gradlew test allureReport生成报告后，打开build/reports/allure-report/index.html，就能看到清晰的自定义信息和测试步骤了。

针对Ant junitreport的补充说明 #

Ant的junitreport默认基于JUnit4的报告格式，对JUnit5的TestReporter支持较差。如果必须用Ant，你可以先让JUnit5生成JUnit4兼容的XML报告，再用junitreport处理：

在Gradle中配置生成JUnit4风格的XML：

test {
    useJUnitPlatform {
        reports {
            junitXml.required = true
            junitXml.outputLocation = file("$buildDir/test-results/junit-compatible")
        }
    }
}

然后在Ant的junitreport任务中读取这些XML，同时确保测试中的自定义信息输出到控制台（参考方案一），这样XML里的system-out节点会包含这些内容，junitreport就能展示了。

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