Spring Boot 3 @SpringBootTest测试未执行网关自动配置问题排查

核心原因分析 #

Spring Boot 3.0 与 Spring Cloud 版本适配不兼容、自动配置加载机制调整，以及测试配置优先级变化，是导致GatewayAutoConfiguration未被评估的主要原因：

1. 版本适配问题：Spring Boot 3.0 必须搭配 Spring Cloud 2022.0.x（代号Kilburn）系列版本，旧版Spring Cloud无法适配Spring Boot 3的自动配置扫描逻辑。
2. 自动配置加载逻辑变更：Spring Boot 3 废弃了spring.factories文件的自动配置声明，改用META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports文件。如果依赖的Spring Cloud Gateway版本未适配此机制，自动配置类不会被Spring容器扫描到。
3. 测试配置优先级冲突：Spring Boot 3 中@SpringBootTest的properties属性优先级高于@TestPropertySource，若你的application.yaml中包含触发Gateway自动配置的关键配置（如spring.cloud.gateway.enabled=true），可能被@SpringBootTest中的配置覆盖，导致条件未触发。
4. 前置依赖缺失：Spring Cloud Gateway 依赖Spring WebFlux，若升级后WebFlux依赖未正确引入，GatewayAutoConfiguration的加载条件会不满足，但你提到类已在类路径，此可能性较低。

针对性调整方案 #

1. 强制适配Spring Cloud版本 #

确保pom.xml中使用与Spring Boot 3.0匹配的Spring Cloud依赖管理：

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-dependencies</artifactId>
            <version>2022.0.4</version> <!-- 适配Spring Boot 3.0的稳定版本 -->
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

2. 修复测试配置优先级问题 #

移除@TestPropertySource，将application.yaml中的必要配置直接整合到@SpringBootTest的properties中，或显式指定spring.cloud.gateway.enabled=true确保触发自动配置：

@SpringBootTest(properties = {
    "instance.role=GATEWAY", 
    "instance.name=test-instance", 
    "debug=true",
    "spring.cloud.gateway.enabled=true" // 显式开启Gateway
})
class GatewayWiringTest {

    @Autowired
    private MySpringBootApplication application;

    @Test
    void gatewayConfigLoads() {
        assertThat(application).isNotNull();
    }
}

若必须保留@TestPropertySource，需确保其配置不会被@SpringBootTest的属性覆盖，可通过调整配置顺序或使用@PropertySource替代。

3. 验证自动配置类的扫描机制 #

检查spring-cloud-gateway-server依赖中的META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports文件是否存在，且包含org.springframework.cloud.gateway.config.GatewayAutoConfiguration。若不存在，说明依赖版本未适配Spring Boot 3，需升级到兼容版本。

4. 检查主应用类的配置 #

确保MySpringBootApplication类未通过@SpringBootApplication(exclude = ...)排除GatewayAutoConfiguration，且@ComponentScan的包范围未限制自动配置类的加载。

5. 补充WebFlux依赖（若缺失） #

若项目中未显式引入WebFlux，添加以下依赖：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-webflux</artifactId>
</dependency>

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