如何通过Extension以编程方式设置JUnit 5测试的DisplayName？

官方推荐方案：使用DisplayNameGenerator扩展点 #

JUnit Jupiter 提供了官方暴露的扩展机制来定制测试显示名称，无需依赖内部私有API或反射：

1. 自定义显示名称生成器
   实现org.junit.jupiter.api.DisplayNameGenerator接口，重写对应方法来定义类或测试方法的显示名称逻辑：

import org.junit.jupiter.api.DisplayNameGenerator;
import java.lang.reflect.Method;

public class CustomDisplayNameGenerator extends DisplayNameGenerator.Standard {
    // 自定义测试类的显示名称
    @Override
    public String generateDisplayNameForClass(Class<?> testClass) {
        return "测试类: " + super.generateDisplayNameForClass(testClass);
    }

    // 自定义测试方法的显示名称
    @Override
    public String generateDisplayNameForMethod(Class<?> testClass, Method testMethod) {
        return testMethod.getName() + " | 参数类型: " + 
               String.join(", ", getParameterTypeNames(testMethod));
    }

    private String[] getParameterTypeNames(Method method) {
        return java.util.Arrays.stream(method.getParameterTypes())
                               .map(Class::getSimpleName)
                               .toArray(String[]::new);
    }
}

2. 应用自定义生成器

• 局部生效：在测试类或方法上添加@DisplayNameGeneration注解

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

@DisplayNameGeneration(CustomDisplayNameGenerator.class)
class UserServiceTest {
    @Test
    void shouldCreateUser(String username, int age) {
        // 测试逻辑
    }
}

• 全局生效：在src/test/resources/junit-platform.properties中配置默认生成器

junit.jupiter.displayname.generator.default=com.your.package.CustomDisplayNameGenerator

为什么不推荐操作内部API？ #

你提到的ClassExtensionContext、MethodExtensionContext属于JUnit Jupiter的包私有内部类，TestDescriptor的displayName也是私有属性且无Setter：

• 强转内部类会导致代码依赖未公开的实现，JUnit版本升级时极易崩溃
• 反射修改私有属性违反封装原则，同样存在版本兼容风险

动态测试的特殊处理 #

如果是生成动态测试，可以直接在创建DynamicTest时指定显示名称，无需依赖Extension：

import org.junit.jupiter.api.DynamicTest;
import org.junit.jupiter.api.TestFactory;
import java.util.stream.Stream;

class DynamicTestDemo {
    @TestFactory
    Stream<DynamicTest> dynamicUserTests() {
        return Stream.of("Alice", "Bob", "Charlie")
                .map(username -> DynamicTest.dynamicTest(
                        "验证用户 " + username + " 的创建逻辑",
                        () -> {
                            // 测试逻辑
                        }));
    }
}

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