微服务一多,新问题从外部冒出来:前端要记十几个服务地址;每个服务各自做鉴权、限流、记日志,重复劳动还要漏;跨域配置散落各处。Spring Cloud Gateway(微服务集群的统一流量入口,做路由转发与统一治理的网关组件)把这一切收编:所有请求先进网关,鉴权、限流、日志在这层一次做完,再按规则转发给后端服务。
职责清单:路由转发(按规则把请求送到目标服务)、统一鉴权(token 校验一次,全家通行)、限流熔断(流量总闸门,16.5 的最外层部署点)、日志监控(请求进出的统一记录点)、灰度分流(按 Header/权重把流量切给新旧版本)。不该做的:业务逻辑。网关里写业务等于造第二个单体——它应该薄、稳、快,只做「与业务无关的交通规则」。
Route(一条路由 = 目标URI + 匹配条件 + 过滤器集合)
Predicate(匹配条件:Path/Method/Header/Query...)
Filter(处理逻辑:改头、限流、鉴权、改写路径...)
配置形态一眼看懂:
spring:
cloud:
gateway:
routes:
- id: order-route
uri: lb://order-service # lb://=去Nacos找实例负载均衡
predicates:
- Path=/api/order/** # 路径匹配才进这条路由
filters:
- StripPrefix=1 # 去掉/api前缀再转发
请求进来后所有 Predicate 逐条试,命中的 Route 进入它的 Filter 链,Pre 过滤器先处理请求(鉴权、加头),代理转发拿到响应后 Post 过滤器再处理响应(改状态码、记耗时)。一条 Filter 链前后包夹,和 Netty Pipeline(12.2)、MVC 拦截器三时点(15.1)是同一思想的网关版。
路由表除了写死在 yaml,还能动态化:接上 Nacos 配置中心,路由规则变成一个 dataId,控制台改一条路由、发布,网关秒级生效不用重启——新服务上线、临时摘流某实例,都从「改配置发版」变成「控制台点一下」。实现路径是监听配置变更事件、构造 RouteDefinition 刷新进 RouteDefinitionWriter,Spring Cloud 官方也有 nacos 版动态路由的参考实现。这个能力的价值在故障时刻最显眼:半夜某实例异常要摘掉,动态路由两分钟止损,静态路由要走完发版流程半小时起步。
灰度分流是 Predicate 组合的漂亮应用:
routes:
- id: order-v2-gray
uri: lb://order-service-v2
predicates:
- Path=/api/order/**
- Header=X-Gray, true # 带灰标头的请求
- id: order-default
uri: lb://order-service # 其余流量走稳定版
predicates:
- Path=/api/order/**
内测用户的请求头带 X-Gray: true 命中 v2 路由,普通用户无感走老版本——先切 5% 流量观察指标,再逐步放大直到全量。发布从「停机一刀切」变成「可控比例的渐进」,出问题秒回退(把灰度路由一摘)。这是网关层送给发布安全的最大红利。
Gateway 底层是 WebFlux + Netty,不是传统 Servlet 栈——面试高频的「为什么」。答案是线程模型:MVC 一个请求占一个 Servlet 线程(Tomcat 默认 200 个),网关作为所有流量的入口,下游稍慢线程池就打满,网关自己成了瓶颈。WebFlux 基于事件循环(12.2 的 Reactor 模型):少量线程非阻塞处理海量并发,等下游响应时不占线程。
代价也随之而来:WebFlux 全链路要求非阻塞,网关过滤器里不能写阻塞代码(JDBC、同步 HTTP 调用都会拖垮事件循环线程),需要阻塞操作必须包装进独立调度器。这也解释了为什么自定义 GlobalFilter 里做鉴权查库时,要么用响应式客户端,要么显式切线程池——入了非阻塞的门,就得守非阻塞的规矩。
@Component
public class AuthGlobalFilter implements GlobalFilter, Ordered {
@Override
public Mono<Void> filter(ServerWebExchange ex,
GatewayFilterChain chain) {
String token = ex.getRequest().getHeaders()
.getFirst("Authorization");
if (!StringUtils.hasText(token)) {
ex.getResponse().setStatusCode(HttpStatus.UNAUTHORIZED);
return ex.getResponse().setComplete(); // 401短路
}
ex.getRequest().mutate() // 校验通过:
.header("X-User-Id", parseUid(token)).build();
return chain.filter(ex); // 放行下游
}
@Override
public int getOrder() { return -1; } // 越小越先执行
}
GlobalFilter(作用于所有路由的全局过滤器)和配置里按路由挂的 GatewayFilter 分工:通用逻辑(鉴权、trace)走全局,单路由定制(特殊改写)走局部。Order 值决定执行顺序,鉴权这类前置逻辑要排到最前面。token 校验后把解析出的用户信息透传给下游,下游服务就不用再各自解析一遍——「网关认证、下游信任」是微服务的标准信任链。
限流也是同理:RequestRateLimiter 过滤器配 Redis 令牌桶(keyResolver 按IP或用户维度),16.5 的算法在网关层再落地一次——网关限全局流量,Sentinel 限服务内部热点,两层闸门各挡各的水。
跨域(CORS:浏览器对跨源请求的安全限制,12.1 讲过预检握手)也该收口在网关:一个配置对象声明允许的源、方法、头,全站后端从此不用各自配——散在服务里的 CORS 配置是经典冲突源(一处 allowedOrigin("*") 一处指定域,浏览器直接报错),统一到城门一处管理,配错也只有一处可改。配套纪律:下游服务的 CORS 配置全部删除,避免响应头重复叠加。
Gateway 是微服务的城门——Route 定路、Predicate 闸门、Filter 海关,底层 WebFlux 非阻塞撑起全量流量;城门只管交通规则不管商贸,薄、稳、快是它的全部修养。