Spring Cloud Gateway 详解：构建高效的API网关解决方案
Spring Cloud Gateway 是 Spring Cloud 生态系统中用于构建 API 网关的核心组件。它基于 Spring WebFlux 构建，旨在提供简单且有效的方式来路由和增强 API 请求。以下是 Spring Cloud Gateway 的详细解释：
核心概念
1. 路由（Route）
路由是 Spring Cloud Gateway 的基本构建块。每个路由包含一个 ID、一个目标 URI、一组断言和一组过滤器。路由的配置决定了哪些请求会被转发到哪个服务。
2. 断言（Predicate）
断言用于匹配进入网关的请求。Spring Cloud Gateway 提供了多种内置断言，如路径断言、方法断言、头部断言等。例如，Path 断言可以匹配 URL 路径。
3. 过滤器（Filter）
过滤器用于在请求和响应过程中对请求进行修改。过滤器有两类：全局过滤器和局部过滤器。全局过滤器对所有路由生效，局部过滤器只对特定路由生效。常见的过滤器包括修改请求头、修改响应头、重写路径等。
配置示例
路由配置
以下是一个基本的配置示例：
spring:
cloud:
gateway:
routes:
- id: example_route
uri: http://example.org
predicates:
- Path=/example/**
filters:
- AddRequestHeader=X-Request-Foo, Bar
在这个例子中，所有路径匹配 /example/** 的请求会被转发到 http://example.org，并且在请求头中添加 X-Request-Foo: Bar。
断言工厂
Spring Cloud Gateway 提供了多种断言工厂：
- Path: 匹配请求路径。
- Method: 匹配 HTTP 方法。
- Header: 匹配请求头。
- Query: 匹配查询参数。
例如：
predicates:
- Path=/foo/**
- Method=GET
- Header=X-Request-Id, \d+
- Query=foo, ba.*
过滤器工厂
常用的过滤器工厂包括：
- AddRequestHeader: 添加请求头。
- AddRequestParameter: 添加请求参数。
- RewritePath: 重写路径。
- StripPrefix: 去除路径前缀。
例如：
filters:
- AddRequestParameter=foo, bar
- RewritePath=/foo/(?<segment>.*), /${segment}
- StripPrefix=1
自定义过滤器
您还可以创建自定义过滤器。实现 GlobalFilter 接口并注入 Spring 容器即可。例如：
import org.springframework.cloud.gateway.filter.GlobalFilter;
import org.springframework.core.Ordered;
import org.springframework.stereotype.Component;
import reactor.core.publisher.Mono;
@Component
public class CustomGlobalFilter implements GlobalFilter, Ordered {
@Override
public Mono<Void> filter(ServerWebExchange exchange, GatewayFilterChain chain) {
// 在此处添加您的逻辑
return chain.filter(exchange);
}
@Override
public int getOrder() {
return -1;
}
}
高级特性
负载均衡
Spring Cloud Gateway 可以与 Spring Cloud LoadBalancer 集成来实现负载均衡。例如：
spring:
cloud:
gateway:
routes:
- id: lb_route
uri: lb://service-id
predicates:
- Path=/loadbalance/**
熔断器
Spring Cloud Gateway 可以与 Resilience4j 集成来实现熔断器模式。例如：
spring:
cloud:
gateway:
routes:
- id: circuitbreaker_route
uri: http://example.org
predicates:
- Path=/circuitbreaker/**
filters:
- name: CircuitBreaker
args:
name: myCircuitBreaker
fallbackUri: forward:/fallback
安全
Spring Cloud Gateway 可以与 Spring Security 集成来保护路由。例如：
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.security.config.annotation.web.reactive.EnableWebFluxSecurity;
import org.springframework.security.config.web.server.ServerHttpSecurity;
import org.springframework.security.web.server.SecurityWebFilterChain;
@Configuration
@EnableWebFluxSecurity
public class SecurityConfig {
@Bean
public SecurityWebFilterChain springSecurityFilterChain(ServerHttpSecurity http) {
http.authorizeExchange()
.pathMatchers("/secure/**").authenticated()
.anyExchange().permitAll()
.and().oauth2Login();
return http.build();
}
}
与 Sentinel 集成
引入依赖
在 pom.xml 文件中引入 Sentinel 的依赖：
<dependency>
<groupId>com.alibaba.cloud</groupId>
<artifactId>spring-cloud-starter-alibaba-sentinel</artifactId>
</dependency>
配置 Sentinel
在 application.yml 中进行基本配置：
spring:
cloud:
sentinel:
transport:
dashboard: localhost:8080
port: 8719
在网关路由中启用 Sentinel
通过配置文件：
spring:
cloud:
gateway:
routes:
- id: example_route
uri: http://example.org
predicates:
- Path=/example/**
filters:
- name: Sentinel
args:
blockHandler: com.example.gateway.sentinel.CustomBlockHandler.handleException
定义 BlockHandler
创建一个自定义的 BlockHandler 来处理被 Sentinel 限流或降级的请求：
package com.example.gateway.sentinel;
import com.alibaba.csp.sentinel.adapter.gateway.sc.callback.BlockRequestHandler;
import com.alibaba.csp.sentinel.adapter.gateway.sc.callback.GatewayCallbackManager;
import org.springframework.context.annotation.Configuration;
import org.springframework.core.io.buffer.DataBuffer;
import org.springframework.http.HttpStatus;
import org.springframework.http.MediaType;
import org.springframework.http.server.reactive.ServerHttpResponse;
import reactor.core.publisher.Mono;
import javax.annotation.PostConstruct;
import java.nio.charset.StandardCharsets;
@Configuration
public class CustomBlockHandler {
@PostConstruct
public void init() {
BlockRequestHandler blockRequestHandler = (exchange, t) -> {
ServerHttpResponse response = exchange.getResponse();
response.setStatusCode(HttpStatus.TOO_MANY_REQUESTS);
response.getHeaders().setContentType(MediaType.APPLICATION_JSON);
String data = "{\"code\":429,\"message\":\"Too Many Requests - Custom BlockHandler\"}";
DataBuffer buffer = response.bufferFactory().wrap(data.getBytes(StandardCharsets.UTF_8));
return response.writeWith(Mono.just(buffer));
};
GatewayCallbackManager.setBlockHandler(blockRequestHandler);
}
}
总结
Spring Cloud Gateway 是一个功能强大且灵活的 API 网关解决方案，适用于微服务架构。它提供了丰富的内置功能和易于扩展的架构，能够满足大多数企业应用的需求。通过断言和过滤器的组合，开发者可以轻松实现复杂的路由和请求处理逻辑。同时，通过与 Sentinel 等工具的集成，可以进一步增强系统的稳定性和高可用性。
