编辑“︁Spring Cloud网关”︁（章节）

== 核心概念 ==  

=== 路由（Route） ===  
路由是网关的基本构建块，包含以下属性：  
* '''ID'''：唯一标识符。  
* '''目标URI'''：请求转发的目标地址。  
* '''断言（Predicate）'''：匹配请求的条件（如路径、Header、方法等）。  
* '''过滤器（Filter）'''：处理请求和响应的逻辑。  

示例路由配置（YAML格式）：  
<syntaxhighlight lang="yaml">  
spring:  
  cloud:  
    gateway:  
      routes:  
        - id: user-service  
          uri: lb://user-service  # 负载均衡目标服务  
          predicates:  
            - Path=/api/users/**  
          filters:  
            - StripPrefix=1       # 移除路径前缀/api  
</syntaxhighlight>  

=== 断言（Predicate） ===  
断言用于定义请求的匹配规则。常用内置断言包括：  
* `Path`：匹配URL路径（支持Ant风格和正则表达式）。  
* `Method`：匹配HTTP方法（如GET、POST）。  
* `Header`：检查请求头是否符合条件。  

=== 过滤器（Filter） ===  
过滤器分为两类：  
* '''全局过滤器（Global Filter）'''：作用于所有路由。  
* '''路由过滤器（Route Filter）'''：仅作用于特定路由。  

示例：添加请求头的自定义过滤器（Java代码）：  
<syntaxhighlight lang="java">  
@Bean  
public RouteLocator customRouteLocator(RouteLocatorBuilder builder) {  
    return builder.routes()  
        .route("test_route", r -> r.path("/test/**")  
            .filters(f -> f.addRequestHeader("X-Custom-Header", "gateway"))  
            .uri("http://localhost:8081"))  
        .build();  
}  
</syntaxhighlight>