@TestInstance与@DirtiesContext：关联、替代关系及底层实现问询

一、核心概念快速梳理 #

• @TestInstance：JUnit5原生注解，用来控制测试类实例的生命周期。默认是PER_METHOD模式（每个测试方法都新建一个测试类实例），可选PER_CLASS模式（整个测试类共用一个实例），主要作用是支持测试类内的状态复用、允许@BeforeAll/@AfterAll使用非静态方法。
• @DirtiesContext：Spring Test模块提供的注解，用来标记Spring应用上下文已被污染，需要在指定时机（测试方法/类执行前/后）销毁并重建上下文，避免测试间的状态污染（比如单例bean被修改后影响后续测试）。

二、二者的关联 #

二者都涉及生命周期管理，但维度完全不同，仅在特定场景下需要配合使用：
当测试类使用@TestInstance(PER_CLASS)时，测试类的所有方法会共用同一个实例，如果某个测试方法修改了Spring上下文里的bean状态（比如修改了单例bean的属性），后续测试方法会复用这个被污染的上下文。这种情况下，就需要结合@DirtiesContext来清理上下文，避免脏状态影响其他测试。

三、实际使用差异 #

1. 管理对象不同 #

• @TestInstance：聚焦于测试类自身的实例，控制测试方法是共享实例还是每次新建。
• @DirtiesContext：聚焦于Spring应用上下文，控制上下文是否需要销毁重建。

2. 解决的问题不同 #

• @TestInstance(PER_CLASS)：满足测试类内的状态复用需求（比如复用初始化成本高的对象），或者简化@BeforeAll/@AfterAll的写法（不用写静态方法）。
• @DirtiesContext：解决Spring上下文被测试修改后的污染问题，确保后续测试能拿到干净的上下文环境。

3. 作用范围与时机不同 #

• @TestInstance：只能作用在测试类上，仅影响当前测试类的实例生命周期。
• @DirtiesContext：可作用在测试类或测试方法上，还能通过hierarchyMode参数控制上下文层级的销毁策略，触发时机可配置为BEFORE_METHOD/AFTER_METHOD/BEFORE_CLASS/AFTER_CLASS。

4. 默认行为不同 #

• @TestInstance默认是PER_METHOD模式，无需显式配置就会为每个测试方法新建实例。
• @DirtiesContext默认不启用，只有显式添加注解并配置时机时，才会触发上下文的销毁重建。

四、@TestInstance 是否旨在替代 @DirtiesContext？ #

完全不是。
二者属于不同模块的功能，设计目标完全独立：

• @TestInstance是JUnit5核心框架的功能，专注于测试类实例的生命周期；
• @DirtiesContext是Spring Test的专属功能，专注于Spring上下文的污染清理。
  甚至在使用PER_CLASS模式时，如果测试修改了Spring上下文状态，反而更需要@DirtiesContext来配合，不存在替代关系。

五、@TestInstance 底层是否使用 @DirtiesContext？ #

完全没有。
@TestInstance是JUnit5原生实现，和Spring的@DirtiesContext分属不同的代码模块，底层逻辑完全独立。即使在Spring Test环境下使用@TestInstance，JUnit5也不会自动触发@DirtiesContext的销毁重建逻辑，二者的执行是相互独立的。

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