在微服务架构盛行的今天，API网关已成为现代后端系统不可或缺的基础设施。作为Spring Cloud生态的核心组件，Spring Cloud Gateway凭借其响应式编程模型和强大的扩展能力，正在逐步取代Zuul成为新一代网关标准。本文将从实战角度，分享我在企业级项目中使用Spring Cloud Gateway的核心经验。
一、为什么选择Spring Cloud Gateway
相比传统的Zuul 1.x，Spring Cloud Gateway基于Spring 5、Spring Boot 2和Project Reactor构建，采用非阻塞IO模型，在性能上有着质的飞跃。在我们的生产环境中，Gateway的单机QPS处理能力比Zuul提升了约40%，内存占用却降低了30%。
更重要的是，Gateway提供了开箱即用的路由、过滤、限流、熔断等功能，配合Spring Cloud生态的无缝集成，让开发者可以快速搭建高可用的API网关层。
二、核心配置实战
以下是我们项目中使用的核心路由配置示例：
spring:
cloud:
gateway:
routes:
- id: user-service
uri: lb://user-service
predicates:
- Path=/api/user/**
filters:
- StripPrefix=1
- name: Retry
args:
retries: 3
statuses: BAD_GATEWAY
- id: order-service
uri: lb://order-service
predicates:
- Path=/api/order/**
filters:
- name: CircuitBreaker
args:
name: orderCircuitBreaker
fallbackUri: forward:/fallback/order
这段配置展示了几个关键点：服务发现集成（lb://前缀）、路径断言、前缀剥离以及熔断降级。特别值得一提的是CircuitBreaker过滤器，它集成了Resilience4j，可以在下游服务异常时自动触发熔断保护。
三、自定义全局过滤器
在企业级应用中，统一的认证鉴权、日志记录、请求追踪是网关层的核心职责。我们通过实现GlobalFilter接口，开发了以下全局过滤器：
@Component
public class AuthGlobalFilter implements GlobalFilter, Ordered {
@Override
public Mono<Void> filter(ServerWebExchange exchange, GatewayFilterChain chain) {
String token = exchange.getRequest().getHeaders().getFirst("Authorization");
if (StringUtils.isEmpty(token)) {
exchange.getResponse().setStatusCode(HttpStatus.UNAUTHORIZED);
return exchange.getResponse().setComplete();
}
// JWT验证逻辑...
return chain.filter(exchange);
}
@Override
public int getOrder() {
return -100; // 确保最先执行
}
}
四、限流策略实践
Gateway内置了基于Redis的限流过滤器RequestRateLimiter。我们在项目中采用了IP+用户双重维度的限流策略：
@Bean
public KeyResolver ipKeyResolver() {
return exchange -> Mono.just(
exchange.getRequest().getRemoteAddress().getAddress().getHostAddress()
);
}
配合Redis的令牌桶算法，可以有效防止突发流量对后端服务的冲击。建议根据业务特点设置不同的限流阈值，核心接口可以适当放宽，而公共接口则需要严格限制。
五、踩坑与经验总结
- 响应式编程的学习曲线：Gateway基于Reactor，开发时需要适应Mono/Flux的编程模式，避免阻塞操作。
- 日志输出不完整：默认情况下，请求体/响应体的日志不会输出，需要通过自定义过滤器实现。
- 跨域配置：建议在Gateway层统一处理CORS，而不是分散到各个微服务。
- 性能调优：合理配置Netty的工作线程数（reactor.netty.ioWorkerCount），通常设置为CPU核心数*2。
结语
Spring Cloud Gateway不仅是一个路由转发工具，更是微服务架构的流量入口和安全屏障。通过合理的路由设计、完善的监控告警、以及针对性的性能优化，它可以支撑起大规模企业级应用的流量治理需求。希望本文的实战经验能为你的网关选型和使用提供参考。
配图来源：Pexels – Technology/Code
