如何修改JUnit5 @TestTemplate以生成层级嵌套的测试容器

针对你开发测试库时遇到的问题——要支持JUnit5标准钩子（@BeforeEach、@Disabled等），同时生成任意深度的嵌套测试结构，以下是可行的解决思路，避开@Nested+@TestTemplate的局限性：

1. 扩展TestTemplateInvocationContextProvider传递层级元数据 #

不用修改已创建的TestTemplateTestDescriptor，而是通过自定义TestTemplateInvocationContextProvider来控制测试节点的层级：

• 在provideTestTemplateInvocationContexts方法中，返回的每个TestTemplateInvocationContext除了测试参数，还要携带当前节点的层级路径（比如Level1/Level2）和节点类型（容器/测试用例）。
• 将这些层级数据存入ExtensionContext.Store，供后续构建嵌套结构使用。

2. 通过TestExecutionListener手动构建嵌套TestDescriptor #

JUnit5允许手动调整测试描述符的父子关系，具体操作：

• 实现自定义TestExecutionListener，在dynamicTestRegistered回调中，从ExtensionContext取出之前存储的层级元数据。
• 根据层级路径逐层创建ContainerTestDescriptor父节点（如果节点不存在），将原有的TestTemplateInvocationTestDescriptor挂载到对应的父容器下。
• 注意父容器的uniqueId必须遵循JUnit5的格式规则，例如[engine:junit-jupiter]/[class:com.yourpkg.YourTest]/[container:Level1]/[container:Level2]，这样IDE和测试报告工具才能正确识别嵌套结构。

3. 确保生命周期钩子生效的核心要点 #

• 自定义的容器TestDescriptor需要继承ClassBasedTestDescriptor或实现TestLifecycleContext接口，这样JUnit5的生命周期钩子会沿着层级向上传播，父容器的钩子能作用于所有子测试用例。
• 全程依托JUnit5的官方扩展机制实现，不要自行编写生命周期逻辑，这样@Disabled、@BeforeAll等标准注解的行为才能保持一致。

4. 备选方案：修复@TestFactory的钩子支持问题 #

如果@TestTemplate的扩展路径受限，可以回头优化@TestFactory方案：

• 在返回DynamicNode树时，给每个DynamicContainer关联对应的测试类ExtensionContext，让容器能继承类层面的钩子配置。
• 自定义DynamicContainer对应的TestDescriptor，使其继承ClassBasedTestDescriptor，确保钩子能正确传播到子节点。

内容的提问来源于stack exchange，提问作者incident-recipient