JUnit 5自动扩展注册失效排查求助

可能导致失效的原因 #

• 扩展类访问权限不足：确保你的扩展类是public修饰的。自动扩展注册要求扩展类必须具备公共可见性，否则即便ServiceLoader能检测到，JUnit也无法实例化它。
• 缺少无参构造函数：JUnit自动加载扩展时会调用无参构造函数，如果你的扩展类仅定义了带参数的构造函数，会导致实例化失败，构造函数自然不会执行。
• JUnit依赖版本不一致：检查项目中junit-jupiter-api、junit-jupiter-engine等核心依赖的版本是否统一。版本不匹配可能导致自动扩展的加载逻辑出现异常。
• 测试类注解或层级冲突：如果测试类本身或父类使用了@ExtendWith指定了其他扩展，或者存在@DisableAutoExtension这类禁用自动扩展的注解，会干扰自动扩展的加载。
• 构建工具或自定义执行器干扰：Maven/Gradle的测试插件若配置了特殊参数，或者项目中使用了自定义测试启动器，可能拦截了自动扩展的加载流程。

负责自动扩展逻辑的Jar包 #

核心逻辑在junit-jupiter-engine包中实现。具体来说，自动扩展的检测与加载逻辑由该包内的org.junit.jupiter.engine.extension.AutoExtensionContextLoader及相关类处理。junit-jupiter-api提供了扩展的基础接口定义，但自动注册的核心执行逻辑属于引擎包。

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