JUnit 5 Maven Surefire插件报告不显示ParameterizedTest参数值

问题场景 #

我编写了如下JUnit 5参数化测试代码：

@ParameterizedTest(name = "{index}: {0}")
@MethodSource("data")
void test_CHECKVALUE(String testCaseDesc, Boolean expected, String input) {
    // 测试逻辑
}

• 在VS Code的Java测试运行器中，测试显示名称为「1: Check Negative Value」，符合预期；
• 但使用Maven Surefire 3.5.2运行时，失败日志仅输出：

  [ERROR] test.value.CHECKVALUE(String, Boolean, String)[4] -- Time elapsed: 1.435 s <<< FAILURE!
  

• 对比JUnit 4的参数化测试，失败日志能正常显示参数信息：

  [ERROR] test.value.DATES[12 (Negative search by Created Date)] -- Time elapsed: 0.410 s <<< FAILURE!
  

解决方案 #

要让Surefire正确解析并显示JUnit 5参数化测试的自定义名称，可通过以下配置实现：

1. 绑定JUnit Jupiter引擎到Surefire插件 #

在pom.xml的构建插件中，为Surefire明确添加JUnit Jupiter引擎依赖，确保插件使用JUnit 5的原生逻辑处理测试名称：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-surefire-plugin</artifactId>
            <version>3.5.2</version>
            <dependencies>
                <dependency>
                    <groupId>org.junit.jupiter</groupId>
                    <artifactId>junit-jupiter-engine</artifactId>
                    <version>5.10.0</version> <!-- 选择与Surefire 3.5.2兼容的版本，建议5.9.x及以上 -->
                </dependency>
            </dependencies>
        </plugin>
    </plugins>
</build>

2. 确保测试方法定义规范 #

测试方法需符合Java语法规范（方法名小写，参数定义清晰），同时保持@ParameterizedTest的name模板正确，比如"{index}: {0}"会将第一个参数作为测试用例描述展示：

@ParameterizedTest(name = "{index}: {0}")
@MethodSource("data")
void test_CHECKVALUE(String testCaseDesc, Boolean expectedResult, String inputValue) {
    // 测试逻辑
}

3. 验证版本兼容性 #

确保JUnit Jupiter的版本与Surefire 3.5.2兼容，官方推荐的组合是JUnit Jupiter 5.9.x及以上搭配Surefire 3.5+，避免因版本不匹配导致的名称解析问题。

原理说明 #

早期Surefire版本对JUnit 5参数化测试的名称处理逻辑与JUnit 4不同，默认仅展示参数类型和索引。通过绑定JUnit Jupiter引擎，Surefire会使用JUnit 5的原生机制读取@ParameterizedTest中定义的自定义名称模板，从而在失败日志中输出包含参数信息的测试名称。

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