使用SpyBean的测试仅在GitLab流水线中失败的问题排查与求助

我来帮你拆解这个问题的核心，再给几个能彻底解决的方案，不用再依赖强制测试顺序啦！

问题回顾 #

你有两个继承同一父类的测试套件，都用@SpyBean模拟同一个MyServiceRetryableClientBean。本地跑测试一切正常，但到了GitLab流水线里，偶尔会出现其中一个测试类的SpyBean没生效、直接调用真实Bean的情况，而且这个问题还跟测试执行顺序有关——把HappyFlow测试放前面就正常，放后面就失败。你现在靠JUnit的ClassOrderer强制顺序临时解决，但想找根本办法避免后续踩坑。

问题根源 #

这事儿本质是Spring测试上下文缓存在搞事情。Spring为了加快测试速度，会把配置相同的测试类的上下文缓存起来复用。你的两个测试类都加了@DirtiesContext(classMode = BEFORE_CLASS)，这个注解的意思是「在当前测试类执行前刷新上下文」，但这里有个坑：

• 如果第一个测试类已经创建并缓存了上下文，第二个测试类执行时，Spring发现上下文配置一致，就会直接复用，不会重新刷新。这时候第二个测试类的@SpyBean可能没法正确覆盖缓存里的Bean，导致Spy失效，调用真实实现。
• 流水线和本地的执行顺序刚好相反，触发了这个缓存冲突的场景，而本地顺序刚好避开了，所以问题偶尔才会出现。

彻底解决方案 #

1. 调整@DirtiesContext模式，让每个测试类用完就销毁上下文 #

把两个测试类的@DirtiesContext改成AFTER_CLASS模式，这样每个测试类跑完就把上下文标记为「脏」，下一个测试类必须创建全新的上下文，彻底隔离：

@ExtendWith(SpringExtension.class)
@DirtiesContext(classMode = DirtiesContext.ClassMode.AFTER_CLASS) // 修改此处
@TestMethodOrder(MethodOrderer.OrderAnnotation.class)
public class ResponseTaskHappyFlowTest extends BatchTaskTest {
    // ... 原有代码不变
}

@ExtendWith(SpringExtension.class)
@DirtiesContext(classMode = DirtiesContext.ClassMode.AFTER_CLASS) // 修改此处
@TestMethodOrder(MethodOrderer.OrderAnnotation.class)
public class ResponseTaskUnhappyFlowTest extends BatchTaskTest {
    // ... 原有代码不变
}

如果测试方法之间也需要完全隔离，可以改成AFTER_EACH_TEST_METHOD，不过测试速度会慢一点，根据你的需求选就行。

2. 给每个测试类加唯一标识，让Spring创建独立上下文 #

通过@TestPropertySource给每个测试类加个独一无二的属性，让Spring认为它们的上下文配置不一样，就不会复用了：

@ExtendWith(SpringExtension.class)
@DirtiesContext(classMode = DirtiesContext.ClassMode.BEFORE_CLASS)
@TestMethodOrder(MethodOrderer.OrderAnnotation.class)
@TestPropertySource(properties = "test.context.id=happy-flow") // 添加唯一标识
public class ResponseTaskHappyFlowTest extends BatchTaskTest {
    // ... 原有代码不变
}

@ExtendWith(SpringExtension.class)
@DirtiesContext(classMode = DirtiesContext.ClassMode.BEFORE_CLASS)
@TestMethodOrder(MethodOrderer.OrderAnnotation.class)
@TestPropertySource(properties = "test.context.id=unhappy-flow") // 添加唯一标识
public class ResponseTaskUnhappyFlowTest extends BatchTaskTest {
    // ... 原有代码不变
}

这种方式不用改@DirtiesContext的模式，还能保证每个测试类有自己独立的上下文，从根源上避免SpyBean冲突。

3. 测试前重置SpyBean状态（适合追求测试速度的场景） #

如果不想放弃上下文缓存的性能优势，可以在每个测试方法前重置SpyBean，清除之前测试留下的状态：

@ExtendWith(SpringExtension.class)
@DirtiesContext(classMode = DirtiesContext.ClassMode.BEFORE_CLASS)
@TestMethodOrder(MethodOrderer.OrderAnnotation.class)
public class ResponseTaskHappyFlowTest extends BatchTaskTest {
    @SpyBean
    private MyServiceRetryableClient myServiceClient;

    @BeforeEach
    void resetSpy() {
        Mockito.reset(myServiceClient); // 重置SpyBean到初始状态
    }

    // ... 原有测试方法
}

记得两个测试类都要加这个重置逻辑，确保每个测试方法启动时，SpyBean都是干净的。

总结 #

用ClassOrderer只是临时绕开了问题，根本解决还是得从上下文隔离或者SpyBean状态重置入手。优先推荐方案1或方案2，彻底消除测试类之间的影响；如果想兼顾测试速度，方案3也是不错的选择。

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