在 Spring Boot 集成测试（如使用 TestRestTemplate）中直接 Mock 静态方法会失败，根本原因在于业务逻辑与测试执行线程分离；通过引入 @TestComponent 实现的 OncePerRequestFilter，可在请求处理线程中安全启用 Mockito 的 mockStatic，实现精准、线程安全的静态方法替换。
在 spring boot 集成测试（如使用 `testresttemplate`）中直接 mock 静态方法会失败，根本原因在于业务逻辑与测试执行线程分离；通过引入 `@testcomponent` 实现的 `onceperrequestfilter`，可在请求处理线程中安全启用 mockito 的 `mockstatic`，实现精准、线程安全的静态方法替换。
Spring Boot 的集成测试（尤其是基于 @SpringBootTest(webEnvironment = RANDOM_PORT) 和 TestRestTemplate 的端到端测试）运行在真实的 Web 容器中，请求由独立的 Tomcat/Jetty 线程处理，而非测试主线程。而 Mockito 5+ 的 mockStatic() 是线程绑定的：它仅对当前调用线程生效。若在测试方法中直接调用 mockStatic()，该 Mock 仅存在于测试线程，对实际处理 HTTP 请求的 Web 容器线程完全无效——这正是 mockStatic 在集成测试中“不工作”的核心原因。
✅ 正确解法：将 Mock 行为注入请求处理生命周期
借助 Spring 的过滤器机制，在每次 HTTP 请求进入时，在业务线程内动态创建并激活静态 Mock。推荐使用 OncePerRequestFilter（确保每个请求只执行一次），并通过 @TestComponent 注册为测试专属 Bean：
@TestComponent
public class TestStaticFilter extends OncePerRequestFilter {
@Override
protected void doFilterInternal(HttpServletRequest request,
HttpServletResponse response,
FilterChain filterChain) throws ServletException, IOException {
// 在请求线程中开启静态 Mock 作用域
try (MockedStatic<YourUtilClass> mock = mockStatic(YourUtilClass.class)) {
// 拦截目标静态方法调用
mock.when(() -> YourUtilClass.buildString()).thenReturn("mocked result");
// 继续请求链路，此时 Controller 中的 static 调用将命中 Mock
filterChain.doFilter(request, response);
}
}
}? 关键要点说明：
- @TestComponent 确保该 Filter 仅在测试环境注册，不会污染生产配置；
- try-with-resources 保证 MockedStatic 在请求结束时自动关闭，避免资源泄漏和跨请求污染；
- OncePerRequestFilter 天然适配 Spring MVC 的请求生命周期，精准覆盖单次请求范围；
- 所有被测 Controller 中对 YourUtilClass.buildString() 的调用，均会在当前请求线程中返回 "mocked result"。
最后，在测试类中通过 @Import 显式引入该 Filter：
@Import(TestStaticFilter.class)
@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)
class UserControllerIntegrationTest {
@Autowired
private TestRestTemplate restTemplate;
@Test
void shouldReturnMockedStringWhenCallingEndpoint() {
ResponseEntity<String> response = restTemplate.getForEntity("/api/test", String.class);
assertThat(response.getBody()).isEqualTo("mocked result"); // ✅ 断言成功
}
}⚠️ 注意事项：
- 确保项目依赖 Mockito 5.0+（mockStatic 自 Mockito 3.4.0 引入，但线程安全性在 5.x 得到强化）；
- 不要尝试在 @BeforeEach 或测试方法内调用 mockStatic() —— 这无法影响 Web 容器线程；
- 若需 Mock 多个静态类，可在同一 doFilterInternal 中链式调用多个 mockStatic()；
- 生产代码中应尽量避免过度依赖静态工具类——优先考虑依赖注入 + 接口抽象，但此方案为遗留系统提供了可靠的测试兜底能力。
该方案已在真实项目中验证稳定，兼顾了集成测试的真实性与 Mock 的精确性，是当前 Spring Boot 场景下 Mock 静态方法的推荐实践。
