JUnit5 @ParameterizedTest 自定义测试用例显示名称的更优实现问询

以下是两种常用的合理实现方案：

方案1：直接添加@SuppressWarnings注解（改动最小） #

直接在未使用的name参数上添加告警抑制注解，明确告诉IDE该参数为有意留空，无需额外编写JavaDoc：

@ParameterizedTest(name = "{0}")
@MethodSource
void testNotNull(@SuppressWarnings("unused") final String name, final String value) {
    assertNotNull(sut.bar(value));
}

• 优点：无需调整参数构造逻辑，兼容所有JUnit 5版本，改动成本极低
• 缺点：方法签名中仍保留无业务作用的参数，仅做告警消除

方案2：使用JUnit 5.8+内置Named类（官方规范方案） #

JUnit 5.8版本新增了org.junit.jupiter.params.provider.Named工具类，专门用于给测试参数绑定自定义显示名称，完全消除无用参数：

import static org.junit.jupiter.params.provider.Named.of;

@ParameterizedTest(name = "{0}")
@MethodSource
void testNotNull(final Named<String> value) {
    // 调用get方法即可获取实际测试参数
    assertNotNull(sut.bar(value.get()));
}

private static Stream<Named<String>> testNotNull() {
    return Stream.of(
        of("empty string", ""),
        of("string with no alphanumerical prefix", "123"),
        of("null string", null)
    );
}

• 优点：完全移除无用参数，语义清晰符合JUnit官方设计规范，无额外告警
• 缺点：需要项目依赖的JUnit Jupiter Params版本 >= 5.8，低版本项目可以先升级依赖，也可以自行实现简单的泛型包装类达到相同效果。

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