当前位置：首页 > news >正文

探索微服务入口：Spring Cloud Gateway 实战指南

news 来源：原创 2025/4/30 6:33:19

在微服务架构中，网关（Gateway）扮演着“请求入口”的角色。它不仅帮助我们统一入口、路由转发，还可以承担限流、安全认证、权限校验、熔断等功能。

本文将系统介绍 Spring Cloud Gateway 的基础概念、快速上手指南，以及在实战中常见的 JWT 登录校验与自定义过滤器开发。

📑 目录

认识网关 Gateway
快速入门：构建你的第一个 Gateway 项目
网关中的登录校验与鉴权逻辑
JWT 登录校验实战
深入理解过滤器：GatewayFilter 与 GlobalFilter
更多实用特性（建议掌握）
总结与建议
Spring Cloud Gateway 与其他网关组件对比

一、认识网关 Gateway

什么是网关？

网关是系统的统一入口，是客户端与后端微服务之间的中间层。主要功能包括：

统一路由转发：将请求路由到具体微服务
服务聚合：对多个微服务的响应进行整合
权限校验：统一登录鉴权，保护后端服务
请求过滤：如限流、日志记录、请求头统一处理等

为什么选择 Spring Cloud Gateway？

Spring Cloud Gateway 是 Spring 团队官方推出的网关组件，基于 WebFlux + Reactor 的响应式编程模型，具有以下优点：

高性能、轻量级
支持路由、过滤器、断言
支持动态路由配置、服务注册发现（Eureka）
支持自定义过滤器和全局过滤器

二、快速入门：构建你的第一个 Gateway 项目

1. 添加依赖

<dependency><groupId>org.springframework.cloud</groupId><artifactId>spring-cloud-starter-gateway</artifactId>
</dependency>
<dependency><groupId>org.springframework.cloud</groupId><artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
</dependency>

2. 配置 application.yml

server:port: 8888spring:application:name: gateway-servicecloud:gateway:routes:- id: user-serviceuri: http://localhost:8081predicates:- Path=/user/**filters:- AddRequestHeader=From, gateway

三、网关中的登录校验与鉴权逻辑

在实际业务中，网关会做以下判断流程：

Client -> Gateway -> [是否为开放接口？]↓[是否带token？]↓[token是否合法/未过期？]↓请求目标服务

四、JWT 登录校验实战

1. JWT 工具类

public class JwtUtil {private static final String SECRET = "my-secret-key";private static final long EXPIRE_TIME = 3600000;public static String createToken(String userId) {return Jwts.builder().setSubject(userId).setExpiration(new Date(System.currentTimeMillis() + EXPIRE_TIME)).signWith(SignatureAlgorithm.HS256, SECRET).compact();}public static Claims parseToken(String token) {return Jwts.parser().setSigningKey(SECRET).parseClaimsJws(token).getBody();}
}

2. 登录校验过滤器（GlobalFilter）

@Component
public class AuthGlobalFilter implements GlobalFilter, Ordered {private static final List<String> WHITE_LIST = List.of("/login", "/register");@Overridepublic Mono<Void> filter(ServerWebExchange exchange, GatewayFilterChain chain) {String path = exchange.getRequest().getURI().getPath();if (WHITE_LIST.stream().anyMatch(path::startsWith)) {return chain.filter(exchange);}String token = exchange.getRequest().getHeaders().getFirst("Authorization");if (StringUtils.isEmpty(token)) {return unauthorized(exchange, "Token 缺失");}try {Claims claims = JwtUtil.parseToken(token);exchange.getRequest().mutate().header("userId", claims.getSubject()).build();} catch (Exception e) {return unauthorized(exchange, "Token 非法或过期");}return chain.filter(exchange);}private Mono<Void> unauthorized(ServerWebExchange exchange, String msg) {exchange.getResponse().setStatusCode(HttpStatus.UNAUTHORIZED);DataBuffer buffer = exchange.getResponse().bufferFactory().wrap(msg.getBytes(StandardCharsets.UTF_8));return exchange.getResponse().writeWith(Mono.just(buffer));}@Overridepublic int getOrder() {return -1;}
}

五、深入理解过滤器：GatewayFilter 与 GlobalFilter

类型	描述	适用范围
GatewayFilter	局部过滤器	某个具体路由
GlobalFilter	全局过滤器	所有路由

自定义 GatewayFilter 示例

@Component
public class CustomGatewayFilterFactory extends AbstractGatewayFilterFactory<CustomGatewayFilterFactory.Config> {public CustomGatewayFilterFactory() {super(Config.class);}public static class Config {private String value;// getter/setter}@Overridepublic GatewayFilter apply(Config config) {return (exchange, chain) -> {exchange.getRequest().mutate().header("X-Custom-Header", config.getValue()).build();return chain.filter(exchange);};}
}

六、更多实用特性（建议掌握）

✅ 动态路由加载（Nacos、数据库）
✅ 熔断与降级（Resilience4j）
✅ 限流功能（RedisRateLimiter）
✅ CORS 跨域配置
✅ 统一异常处理
✅ 日志追踪（链路追踪 Zipkin）

七、总结与建议

Spring Cloud Gateway 是现代微服务架构中非常关键的一环，不仅用于请求路由，更是安全、稳定、高可用架构的第一道防线。

建议：

提前规划路由结构
使用 JWT 做轻量级认证
用过滤器做灵活的扩展（如添加请求头、参数校验、限流等）
对白名单、黑名单接口单独设计
接入链路追踪和监控组件

八、Spring Cloud Gateway 与其他网关组件对比

网关组件	技术架构	性能	动态路由	插件扩展性	适合场景
Spring Cloud Gateway	Java + WebFlux	⭐⭐⭐⭐	✅	高	Spring 微服务体系
Zuul 1.x	Java + Servlet	⭐⭐	✅	中	老项目兼容
Zuul 2.x	Netty	⭐⭐⭐⭐	✅	中	Netflix 内部使用
Nginx	C语言	⭐⭐⭐⭐⭐	⛔	低（Lua）	静态资源、边缘代理
Kong	Nginx + Lua	⭐⭐⭐⭐	✅	高	API 网关平台
Traefik	Go	⭐⭐⭐⭐	✅	中	云原生、K8s 场景

✅ Spring Cloud Gateway 优势

Spring Cloud 深度集成
WebFlux 高性能
支持自定义过滤器与动态路由

❌ 不足

JVM 性能劣于 Nginx
插件生态弱于 Kong
学习曲线相对偏高

场景选型建议

场景	推荐网关
Java 微服务系统	✅ Spring Cloud Gateway
高性能边缘代理	✅ Nginx
企业级 API 管理	✅ Kong
云原生微服务治理	✅ Traefik
老项目兼容迁移	✅ Zuul（不推荐新项目）

希望本文能帮助你全面理解 Spring Cloud Gateway 的能力和应用场景，如果你需要更多高级实践如自定义限流、动态路由注册、网关聚合文档等，欢迎留言获取进阶篇！