Spring Boot3与Spring Cloud Gateway集成测试失效问题求助

问题根源 #

Spring Cloud Gateway基于WebFlux（Reactive栈），与Spring MVC（Servlet栈）无法在同一应用上下文中共存。你设置spring.main.web-application-type=reactive后，应用上下文变为ReactiveWebApplicationContext，而原有集成测试依赖的是Servlet栈的WebApplicationContext，因此抛出NoSuchBeanDefinitionException。

解决方案 #

1. 为不同测试场景单独指定Web应用类型（过渡阶段首选）

• 针对Spring MVC逻辑的集成测试，在测试类上添加@TestPropertySource，强制使用Servlet栈上下文：

  @SpringBootTest
  @TestPropertySource(properties = "spring.main.web-application-type=servlet")
  public class MvcServiceIntegrationTest {
      @Autowired
      private WebApplicationContext webApplicationContext;
      
      // MVC相关测试逻辑
  }
  

• 针对Spring Cloud Gateway路由测试，使用Reactive栈上下文，注入ReactiveWebApplicationContext：

  @SpringBootTest
  @TestPropertySource(properties = "spring.main.web-application-type=reactive")
  public class GatewayRouteIntegrationTest {
      @Autowired
      private ReactiveWebApplicationContext reactiveWebApplicationContext;
      
      // 网关路由相关测试逻辑
  }
  

2. 拆分网关为独立服务（长期推荐）

官方明确不支持Spring MVC与WebFlux在同一应用中混用，长远来看，建议将Spring Cloud Gateway的代理逻辑拆分为独立的纯Reactive栈应用，原应用保持Spring MVC栈。这样：

• 两个应用各司其职，避免上下文冲突
• 测试可以独立编写，无需处理混合栈的兼容性问题
• 符合微服务拆分的设计原则

3. 测试中使用条件注入兼容两种上下文

如果不想拆分测试类，可以通过条件注入同时兼容两种上下文，并控制测试执行逻辑：

@SpringBootTest
public class MixedIntegrationTest {
    @Autowired(required = false)
    private WebApplicationContext servletContext;
    
    @Autowired(required = false)
    private ReactiveWebApplicationContext reactiveContext;
    
    @Test
    void testMvcBusinessLogic() {
        // 仅在Servlet上下文存在时执行测试
        Assertions.assertNotNull(servletContext);
        // MVC测试逻辑
    }
    
    @Test
    void testGatewayRouting() {
        // 仅在Reactive上下文存在时执行测试
        Assertions.assertNotNull(reactiveContext);
        // 网关测试逻辑
    }
}

也可以配合@EnabledIf注解更精准地控制测试方法的执行条件。

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