Spring Cloud Gateway拆分路由后仅加载最后一个路由的问题求助

问题场景 #

在Spring Cloud Gateway中拆分路由到独立配置文件，通过spring.profiles.include导入后，仅最后一个路由文件的配置生效，前置文件的路由被覆盖。

原配置示例 #

application-route1.yml #

spring:
  cloud:
    gateway:
      routes:
        - id: employee-route
          uri: http://localhost:8085
          predicates:
            - Path=/employee/**

application-route2.yml #

spring:
  cloud:
    gateway:
      routes:
        - id: consumer-route
          uri: http://localhost:8086
          predicates:
            - Path=/consumer/**

主配置文件（application.yml） #

spring:
  application:
    name: edge-gateway-service
  profiles:
    include: > 
      route1,
      route2

问题原因 #

Spring Boot的配置加载机制中，当多个配置文件定义同一个列表类型属性（如spring.cloud.gateway.routes）时，后加载的配置会直接覆盖前置配置的列表，而非合并列表项，导致仅最后一个文件的路由生效。

解决方案 #

方案1：索引式配置合并（推荐） #

修改路由文件，为每个路由指定唯一的列表索引，让Spring Boot自动合并列表项：

修改后的application-route1.yml

spring:
  cloud:
    gateway:
      routes[0]:
        id: employee-route
        uri: http://localhost:8085
        predicates:
          - Path=/employee/**

修改后的application-route2.yml

spring:
  cloud:
    gateway:
      routes[1]:
        id: consumer-route
        uri: http://localhost:8086
        predicates:
          - Path=/consumer/**

主配置文件保持不变，此时Spring Boot会将不同索引的路由合并为一个完整的路由列表。

方案2：使用spring.config.import导入配置片段（Spring Boot 2.4+） #

利用Spring Boot 2.4+新增的spring.config.import特性，直接导入配置文件并自动合并列表属性：

修改主配置文件：

spring:
  application:
    name: edge-gateway-service
  config:
    import:
      - classpath:application-route1.yml
      - classpath:application-route2.yml

注意：此时路由文件无需遵循application-*.yml的profile命名规则，可改为route1.yml、route2.yml等，避免被当作profile加载。

方案3：编程式路由加载（灵活度高） #

编写配置类，自定义路由加载逻辑，从多个配置源读取路由并注册：

import org.springframework.cloud.gateway.route.RouteLocator;
import org.springframework.cloud.gateway.route.builder.RouteLocatorBuilder;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.core.env.Environment;

@Configuration
public class GatewayRouteConfig {

    @Bean
    public RouteLocator customRouteLocator(RouteLocatorBuilder builder, Environment env) {
        RouteLocatorBuilder.Builder routeBuilder = builder.routes();

        // 加载employee路由
        routeBuilder.route("employee-route", 
            r -> r.path("/employee/**")
                  .uri(env.getProperty("gateway.routes.employee.uri", "http://localhost:8085")));

        // 加载consumer路由
        routeBuilder.route("consumer-route", 
            r -> r.path("/consumer/**")
                  .uri(env.getProperty("gateway.routes.consumer.uri", "http://localhost:8086")));

        return routeBuilder.build();
    }
}

对应可将路由配置简化为独立的配置片段（如route-configs.yml），集中管理路由参数：

gateway:
  routes:
    employee:
      uri: http://localhost:8085
    consumer:
      uri: http://localhost:8086

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