Spring Cloud Gateway 实战：构建高可用微服务 API 网关的五个关键设计

在微服务架构演进中，服务拆分带来了独立部署与弹性伸缩的红利，也引入了一个绕不开的问题：外部客户端该如何与数十乃至上百个内部服务通信？直接暴露所有服务显然不可行，API 网关因此成为微服务体系的"统一入口"。Spring Cloud Gateway 基于 Spring WebFlux 与 Reactor 实现非阻塞 IO，在吞吐与资源占用上相较传统 Zuul 1.x 有数量级提升。本文围绕路由、鉴权、限流、熔断、统一响应五个关键设计，给出一套可落地的工程实践。

一、动态路由：配置即代码

网关最核心的职责是请求转发。Spring Cloud Gateway 采用"断言 + 过滤器"模型描述路由，推荐将路由配置外置到 Nacos，实现不重启网关即可调整转发规则。

spring:
  cloud:
    gateway:
      routes:
        - id: user-service
          uri: lb://user-service
          predicates:
            - Path=/api/users/**
          filters:
            - StripPrefix=1
            - name: Retry
              args:
                retries: 3
                statuses: BAD_GATEWAY,GATEWAY_TIMEOUT