← 课程目录 🚀 从零到一
📐 学习维度 阶段4 · 第16章 微服务(Spring Cloud Alibaba) 🚀 从零到一 📚 课程目录 🏠 首页 🛤️ 学习路径

16.4 Gateway 网关与过滤器链

审校 2026-09-25 · 素材来源:L33-微服务架构(底稿改写)、gateway_learning
📑 本篇章节导航 (共7节,点击直达)
网关该做什么、不该做什么三大概念:Route、Predicate、Filter为什么是 WebFlux 而不是 MVC自定义全局过滤器:统一鉴权实战踩坑清单面试怎么问一句话总结

微服务一多,新问题从外部冒出来:前端要记十几个服务地址;每个服务各自做鉴权、限流、记日志,重复劳动还要漏;跨域配置散落各处。Spring Cloud Gateway(微服务集群的统一流量入口,做路由转发与统一治理的网关组件)把这一切收编:所有请求先进网关,鉴权、限流、日志在这层一次做完,再按规则转发给后端服务。

网关该做什么、不该做什么

职责清单:路由转发(按规则把请求送到目标服务)、统一鉴权(token 校验一次,全家通行)、限流熔断(流量总闸门,16.5 的最外层部署点)、日志监控(请求进出的统一记录点)、灰度分流(按 Header/权重把流量切给新旧版本)。不该做的:业务逻辑。网关里写业务等于造第二个单体——它应该薄、稳、快,只做「与业务无关的交通规则」。

三大概念:Route、Predicate、Filter


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% 流量观察指标,再逐步放大直到全量。发布从「停机一刀切」变成「可控比例的渐进」,出问题秒回退(把灰度路由一摘)。这是网关层送给发布安全的最大红利。

为什么是 WebFlux 而不是 MVC

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 非阻塞撑起全量流量;城门只管交通规则不管商贸,薄、稳、快是它的全部修养。