Spring Cloud Gateway入门

### Spring Cloud Gateway 入门教程 #### 1. Spring Cloud Gateway 的基本概念 Spring Cloud Gateway 是基于 Spring Framework 5、Project Reactor 和 Spring Boot 2 构建的一个高性能网关框架，它提供了非阻塞式的 API 支持[^2]。作为微服务架构中的重要组成部分，它的主要功能是对 HTTP 请求进行路由转发并提供过滤能力。 #### 2. 工作原理概述 Spring Cloud Gateway 的工作流程可以分为以下几个部分： - **路由匹配**：通过预定义的路由规则来决定请求应该被发送到哪个目标服务。 - **过滤器执行**：在请求到达目标服务之前以及返回客户端之后，可以通过一系列的过滤器对请求和响应进行处理[^1]。 #### 3. 路由配置详解 路由是 Spring Cloud Gateway 中的核心概念之一，其配置通常包括以下几项： - `id`：唯一标识符用于区分不同的路由规则。 - `uri`：指定目标服务地址。 - `predicates`：一组断言函数用来判断当前请求是否满足条件。 - `filters`：应用在此路由上的过滤逻辑列表。 下面是一个简单的 YAML 配置例子展示如何设置一个基本路由： ```yaml spring: cloud: gateway: routes: - id: example_route uri: http://example.org predicates: - Path=/example/** filters: - AddRequestHeader=foo, bar ``` 上述代码片段展示了如何创建一条名为 `example_route` 的路径映射，并向所有符合条件的请求头添加键值对 `foo:bar`[^4]。 #### 4. 网关过滤器的作用与分类 网关过滤器允许开发者以特定的方式修改进入系统的 HTTP 请求或者离开系统的 HTTP 响应。按照作用范围划分，它们可分为局部过滤器(Local Filters)和全局过滤器(Global Filters)。其中前者仅应用于单一路由上而后者则影响整个应用程序内的每一个请求/回应周期。 #### 5. 自定义谓词(Predicate) 除了内置的标准外,Spring Cloud Gateway还支持用户自行扩展新的谓词类以便更灵活地控制流量行为模式[^5]。这使得我们可以针对特殊需求设计专属解决方案而不局限于现有选项集之内. --- ### 实践案例分享 假设我们需要实现这样一个场景——当访问 `/api/v1/users/{userId}` 接口时如果参数 userId 小于等于零就拒绝该次调用，则可通过如下方式完成: ```java @Bean public RouteLocator customRouteLocator(RouteLocatorBuilder builder){ return builder.routes() .route(r -> r.path("/api/v1/users/**") .and().args("userId", (arg)->Integer.parseInt(arg)<0 ) .filter((exchange, chain) -> ServerResponse.status(HttpStatus.BAD_REQUEST).build()) .uri("lb://USER-SERVICE")) .build(); } ``` 此段程序利用了复合型 Predicates 来组合多个简单条件形成复杂查询表达式的同时也引入了一个错误处理器 Filter 当检测失败时候立即中断链路并向外部反馈状态码信息。 ---