SpringCloudGateway路由配置全解析

“纵有疾风来，人生不言弃”，这句话送给正在学习文章的朋友们，也希望在阅读本文《Spring Cloud Gateway路由配置详解》后，能够真的帮助到大家。我也会在后续的文章中，陆续更新文章相关的技术文章，有好的建议欢迎大家在评论留言，非常感谢！

Spring Cloud Gateway可通过配置文件或Java代码配置路由，推荐使用yml方式。示例中通过Path断言匹配请求路径，StripPrefix过滤器去除前缀后转发至指定uri；也可通过RouteLocatorBuilder编写Java配置实现更灵活的路由逻辑；结合Eureka时使用lb://协议实现服务发现与负载均衡；需注意避免引入spring-webmvc以防止与WebFlux冲突，且路由顺序影响匹配优先级。

在Java后端开发中，Spring Cloud Gateway 是微服务架构里常用的网关组件，负责请求的路由转发和过滤。配置路由是它的核心功能之一。你可以通过两种方式来配置：一种是使用配置文件（推荐），另一种是通过 Java 代码硬编码。

1. 使用 application.yml 配置路由

这是最常见、最简洁的方式。你只需要在 application.yml 文件中定义路由规则即可。

示例配置：

spring:
  cloud:
    gateway:
      routes:
        - id: user-service-route
          uri: http://localhost:8081
          predicates:
            - Path=/api/users/**
          filters:
            - StripPrefix=1
    - id: order-service-route
      uri: http://localhost:8082
      predicates:
        - Path=/api/orders/**
      filters:
        - StripPrefix=1

说明：

• id：路由唯一标识。
• uri：目标服务地址，可以是 http 地址，也可以是 lb:// 开头的负载均衡服务名（如 lb://userservice）。
• predicates：断言，用于匹配请求。上面的 Path=/api/users/** 表示路径以 /api/users/ 开头的请求会被转发。
• filters：过滤器，StripPrefix=1 表示去掉第一层路径前缀再转发。比如 /api/users/list 转发到后端时变为 /list。

2. 使用 Java 配置类方式

如果你需要更灵活的控制，可以用 Java 代码定义路由。

示例：

@Configuration
public class GatewayConfig {
@Bean
public RouteLocator customRouteLocator(RouteLocatorBuilder builder) {
    return builder.routes()
        .route("user_route", r -> r.path("/api/users/**")
            .filters(f -> f.stripPrefix(1))
            .uri("http://localhost:8081"))
        .route("order_route", r -> r.path("/api/orders/**")
            .filters(f -> f.stripPrefix(1))
            .uri("http://localhost:8082"))
        .build();
}
}

这种方式适合动态或条件性路由逻辑，但日常使用中 yml 更清晰。

3. 结合 Eureka 实现服务发现

在微服务场景下，通常配合注册中心（如 Eureka）使用，让网关自动发现服务实例。

配置示例：

spring:
  cloud:
    gateway:
      routes:
        - id: user-service
          uri: lb://user-service
          predicates:
            - Path=/api/users/**
          filters:
            - StripPrefix=1

注意：uri 使用 lb:// 前缀表示启用负载均衡，user-service 是服务在 Eureka 中注册的名称。

4. 常见问题和建议

确保以下几点避免常见错误：

• 添加必要的依赖，如 spring-cloud-starter-gateway 和 spring-cloud-starter-netflix-eureka-client（如果用了注册中心）。
• 不要在项目中引入 spring-webmvc，否则会与 WebFlux 冲突。
• 路径匹配顺序很重要，写在前面的路由优先级更高。
• 可以用多个 predicate 组合，如 Host、Method、Query 等。

基本上就这些。用 yml 配置路由简单高效，适合大多数场景。结合服务发现后，网关能自动路由到正确的微服务。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《SpringCloudGateway路由配置全解析》文章吧，也可关注golang学习网公众号了解相关技术文章。