如何用WireMockServer测试@RequestScope组件？遇无线程绑定请求异常

这个问题我太熟悉了！你遇到的java.lang.IllegalStateException本质上是因为**@RequestScope**标注的组件必须依附于一个活跃的HTTP请求上下文，但用WireMock做测试时，默认情况下测试线程并没有绑定任何请求上下文，Spring找不到对应的请求属性，自然就报错了。下面给你两种实用的解决方案：

这是直接测试@RequestScope组件本身的最优方案，步骤简单清晰：

• 在测试执行前，创建模拟HTTP请求并绑定到当前线程：

  @BeforeEach
  void setUpRequestContext() {
      MockHttpServletRequest mockRequest = new MockHttpServletRequest();
      RequestContextHolder.setRequestAttributes(new ServletRequestAttributes(mockRequest));
  }
  

• 测试结束后必须清理上下文，避免污染其他测试用例：

  @AfterEach
  void tearDownRequestContext() {
      RequestContextHolder.resetRequestAttributes();
  }
  

• 完整测试示例：

  @SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)
  class RequestScopedComponentTest {
  
      @Autowired
      private RequestScopedComponent myRequestScopedBean;
  
      @Autowired
      private WireMockServer wireMockServer;
  
      @BeforeEach
      void setUp() {
          // 配置WireMock模拟外部服务
          wireMockServer.stubFor(get(urlEqualTo("/external-service"))
                  .willReturn(aResponse().withStatus(200).withBody("mock-data")));
          // 绑定请求上下文
          MockHttpServletRequest request = new MockHttpServletRequest();
          RequestContextHolder.setRequestAttributes(new ServletRequestAttributes(request));
      }
  
      @AfterEach
      void tearDown() {
          RequestContextHolder.resetRequestAttributes();
      }
  
      @Test
      void whenUsingRequestScopedBean_thenNoException() {
          String result = myRequestScopedBean.fetchDataFromExternal();
          assertEquals("mock-data", result);
      }
  }
  

如果你的@RequestScope组件是在控制器请求流程中被调用的，用MockMvc发起模拟请求会更贴近真实业务场景，Spring会自动帮你管理请求上下文：

• 用@WebMvcTest（轻量）或@SpringBootTest搭配MockMvc：

  @WebMvcTest(MyController.class)
  class RequestScopedComponentIntegrationTest {
  
      @Autowired
      private MockMvc mockMvc;
  
      @Autowired
      private WireMockServer wireMockServer;
  
      @BeforeEach
      void setUpWireMock() {
          wireMockServer.stubFor(get(urlEqualTo("/external-service"))
                  .willReturn(aResponse().withStatus(200).withBody("mock-response")));
      }
  
      @Test
      void whenControllerCallsRequestScopedBean_thenWorks() throws Exception {
          mockMvc.perform(get("/api/my-endpoint"))
                  .andExpect(status().isOk())
                  .andExpect(content().string("mock-response"));
          // 此时请求上下文由MockMvc自动绑定，@RequestScope组件可以正常工作
      }
  }
  

Spring的@RequestScope是基于线程绑定的请求属性实现的——每个请求对应一个线程，Spring会把请求作用域的Bean和当前线程的请求属性绑定。测试时如果没有触发真实的请求流程，也没有手动绑定上下文，线程中就没有对应的请求属性，自然会抛出那个异常。

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