JUnit 5实现Spring Boot测试类前置继承校验的问题排查

问题根源分析 #

你当前的实现存在两个核心问题导致扩展未生效：

1. 不必要的接口实现：你的扩展类实现了TestTemplateInvocationContextProvider接口，该接口仅用于支持@ParameterizedTest这类测试模板场景，且你未实现该接口的必填方法（supportsTestTemplate和provideTestTemplateInvocationContexts），这会导致JUnit无法正确识别该扩展为全局前置回调。
2. 检查逻辑不严谨：原代码仅判断父类是否为Object或不存在，但未覆盖间接继承的场景，且没有准确匹配指定的父类A、B、C。

修正后的扩展实现 #

我们只需要实现BeforeAllCallback接口（类级别的前置检查，每个测试类仅执行一次，比BeforeEachCallback更高效），并完善检查逻辑：

import org.junit.jupiter.api.extension.BeforeAllCallback;
import org.junit.jupiter.api.extension.ExtensionContext;
import java.lang.reflect.Modifier;

public class InheritClassTestCheckExtension implements BeforeAllCallback {

    // 指定允许的父类列表
    private static final Class<?>[] ALLOWED_PARENT_CLASSES = {A.class, B.class, C.class};

    @Override
    public void beforeAll(ExtensionContext context) throws Exception {
        Class<?> testClass = context.getRequiredTestClass();

        // 跳过抽象测试类的检查（抽象类不会被直接执行测试）
        if (Modifier.isAbstract(testClass.getModifiers())) {
            return;
        }

        // 检查测试类是否继承自指定父类（支持间接继承）
        boolean isInheritedFromAllowedClass = false;
        for (Class<?> allowedParent : ALLOWED_PARENT_CLASSES) {
            if (allowedParent.isAssignableFrom(testClass)) {
                isInheritedFromAllowedClass = true;
                break;
            }
        }

        if (!isInheritedFromAllowedClass) {
            throw new IllegalStateException("测试类必须继承自A、B或C中的一个");
        }
    }
}

扩展自动加载的正确配置 #

有两种可靠方式让JUnit自动加载该扩展，二选一即可：

方式1：通过junit-platform.properties配置 #

在src/test/resources目录下创建junit-platform.properties文件，添加以下配置：

junit.jupiter.extensions.autodetection.enabled=true
junit.jupiter.extensions.autodetection.names=com.my.package.InheritClassTestCheckExtension

注意：确保配置的扩展类全限定名与实际代码完全一致，且扩展类为public、有无参构造方法。

方式2：通过SPI机制配置 #

在src/test/resources目录下创建META-INF/services/org.junit.jupiter.api.extension.Extension文件，文件内容为扩展类的全限定名：

com.my.package.InheritClassTestCheckExtension

这种方式是Java标准的服务发现机制，兼容性更强。

补充说明 #

• 若你的测试类有多层继承（比如测试类继承自D，D继承自A），isAssignableFrom方法会正确识别这种间接继承关系，比直接调用getSuperclass更全面。
• 使用BeforeAllCallback而非BeforeEachCallback可以避免每个测试方法都重复执行检查逻辑，提升测试效率。

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