文章目录Spring Cloud Gateway 统一服务入口一、依赖版本Boot 4 与 Boot 3 差异二、为什么需要网关三、依赖与启动类3.1 gateway/pom.xml3.2 启动类四、配置文件4.1 application-dev.yml4.3 路由字段说明五、断言Route Predicate六、过滤器Gateway Filter七、总结Spring Cloud Gateway 统一服务入口一、依赖版本组件版本说明Java21Spring Boot4.1.0父 POM 统一管理Spring Cloud2025.1.2spring-cloud-dependenciesSpring Cloud Alibaba2025.1.0.0spring-cloud-alibaba-dependencies父 POM 版本锁定propertiesjava.version21/java.versionspring-cloud.version2025.1.2/spring-cloud.versionspring-cloud-alibaba.version2025.1.0.0/spring-cloud-alibaba.version/propertiesBoot 4 与 Boot 3 差异对比项Boot 3Boot 4当前项目Gateway 依赖spring-cloud-starter-gatewayspring-cloud-starter-gateway-server-webflux路由配置spring.cloud.gateway.routesspring.cloud.gateway.server.webflux.routes默认过滤器spring.cloud.gateway.default-filtersspring.cloud.gateway.server.webflux.default-filters旧 starter 在 Cloud 2025 BOM 中已移除继续使用会报依赖无法加载。二、为什么需要网关微服务拆分后Nacos 解决注册发现LoadBalancer 解决负载均衡OpenFeign 解决服务间调用。但接口仍分散在各服务端口上问题说明入口分散客户端需分别访问 8080、8081 等重复鉴权每个服务都要做权限校验Gateway 作为统一入口外部只访问9000内部按路由转发到lb://order-service/lb://product-service。服务端口注册名gateway9000gatewayorder-service8080order-serviceproduct-service8081 / 8082 / 8083product-service网关是否和拦截器切面等重复冗余?网关过滤器大门外运行在请求进入微服务集群之前是流量的大门。它属于WebFluxNetty层不依赖 Servlet 容器。拦截器/切面大门内运行在请求已经进入具体的微服务应用之后。它属于 Spring MVCServlet 容器依赖具体的 Controller 或 Service。如果网关已经拦截如 Token 过期请求直接返回 401根本不会到达拦截器和切面——这节省了内部服务的线程资源。结论网关管“能不能进门”拦截器管“进门后坐哪”切面管“坐下后具体怎么做”。三者配合而不是互相替代。三、依赖与启动类3.1 gateway/pom.xml!-- Gateway WebFluxBoot 4 新 starter禁止引入 spring-boot-starter-web --dependencygroupIdorg.springframework.cloud/groupIdartifactIdspring-cloud-starter-gateway-server-webflux/artifactId/dependency!-- lb://服务名 负载均衡必须单独引入 --dependencygroupIdorg.springframework.cloud/groupIdartifactIdspring-cloud-starter-loadbalancer/artifactId/dependency!-- Nacos 服务发现 --dependencygroupIdcom.alibaba.cloud/groupIdartifactIdspring-cloud-starter-alibaba-nacos-discovery/artifactId/dependency3.2 启动类SpringBootApplication// Spring Boot 自动配置EnableDiscoveryClient// 注册到 Nacos服务名 gatewaypublicclassGatewayApplication{publicstaticvoidmain(String[]args){// 应用入口SpringApplication.run(GatewayApplication.class,args);}}四、配置文件4.1 application-dev.ymlserver:port:9000# 网关监听端口spring:cloud:nacos:discovery:server-addr:127.0.0.1:8848# Nacos 注册中心地址loadbalancer:nacos:enabled:true# 启用 Nacos 权重/集群负载均衡策略gateway:server:webflux:default-filters:-AddResponseHeaderX-Gateway,spring-cloud-gateway# 全局响应头routes:-id:order-route# 路由 IDuri:lb://order-service# 负载均衡转发到 order-servicepredicates:-Path/order/**# 路径断言-MethodGET,POST# 方法断言filters:-AddRequestHeaderX-Request-Source,gateway# 添加请求头-id:product-route# 路由 IDuri:lb://product-service# 负载均衡转发到 product-servicepredicates:-Path/product/**# 路径断言-MethodGET,POST# 方法断言filters:-AddRequestHeaderX-Request-Source,gateway# 添加请求头-id:product-by-id-route# 带 Query 断言的路由uri:lb://product-service# 目标服务predicates:-Path/product/getProductById# 精确路径-Queryid,\d# id 必须为数字-MethodGET# 仅 GETfilters:-AddRequestHeaderX-Matched-Route,product-by-id# 标记命中的路由-id:order-api-route# StripPrefix 示例路由uri:lb://order-service# 目标服务predicates:-Path/api/order/**# /api/order/xxxfilters:-StripPrefix1# 去掉 /api 前缀转发为 /order/xxx-id:product-legacy-route# RewritePath 示例路由uri:lb://product-service# 目标服务predicates:-Path/legacy/product/**# 旧路径filters:-RewritePath/legacy/product/(?segment.*),/product/${segment}# 重写为新路径logging:level:org.springframework.cloud.gateway:debug# Gateway 调试日志org.springframework.cloud.loadbalancer:debug# 负载均衡调试日志4.3 路由字段说明字段说明id路由唯一标识uri目标地址lb://服务名从 Nacos 取实例并负载均衡predicates断言全部满足才匹配ANDfilters匹配后对请求/响应的处理五、断言Route Predicateyml 中的断言字符串由Route Predicate Factory解析多个断言默认AND关系。名称说明配置示例Path路径匹配Path/product/**MethodHTTP 方法匹配MethodGET,POSTQueryQuery 参数正则匹配Queryid, \dAfter指定时间之后的请求After2024-01-01T00:00:00.00008:00[Asia/Shanghai]Before指定时间之前的请求Before2025-12-31T23:59:59.00008:00[Asia/Shanghai]Between两个时间之间的请求Between开始时间, 结束时间HeaderHeader 值正则匹配HeaderX-Request-Id, \dCookieCookie 值正则匹配Cookietoken, .Host请求 Host 匹配Host**.example.comRemoteAddr请求 IP 段匹配RemoteAddr192.168.1.1/24时间断言设为未来时间时当前请求会 404路由不匹配。六、过滤器Gateway FilterPredicate 决定走哪条路由Filter 决定路上做什么。Filter 分Pre转发后端前和Post响应返回前。名称类型说明配置示例AddResponseHeaderGatewayFilter / default-filters添加响应 HeaderAddResponseHeaderX-Gateway, spring-cloud-gatewayAddRequestHeaderGatewayFilter添加请求 HeaderAddRequestHeaderX-Request-Source, gatewayAddRequestParameterGatewayFilter添加 Query 参数AddRequestParameteruserName, biteRemoveRequestHeaderGatewayFilter删除请求 HeaderRemoveRequestHeaderX-Request-FooRemoveResponseHeaderGatewayFilter删除响应 HeaderRemoveResponseHeaderX-Response-FooStripPrefixGatewayFilter去掉路径前缀段StripPrefix1RewritePathGatewayFilter正则重写路径RewritePath/legacy/product/(?segment.*), /product/${segment}PrefixPathGatewayFilter添加路径前缀PrefixPath/apiRequestRateLimiterGatewayFilter限流需 Redisname: RequestRateLimiter redis 参数RetryGatewayFilter失败重试name: Retryretries: 3RequestSizeGatewayFilter限制请求体大小name: RequestSizemaxSize: 5000000LoadBalancerClientFilterGlobalFilter解析lb://并负载均衡内置无需 ymlGateway Metrics FilterGlobalFilter监控指标需 actuator执行顺序order 越小越先执行order 相同时defaultFilterGatewayFilterGlobalFilter。七、总结主题要点版本Boot 4.1.0 Cloud 2025.1.2 Alibaba 2025.1.0.0 Java 21依赖gateway-server-webfluxloadbalancernacos-discovery配置前缀spring.cloud.gateway.server.webflux.*入口gateway:9000 →lb://order-service/lb://product-service负载均衡loadbalancer.nacos.enabled: true断言多条件 ANDPath / Method / Query 等过滤器default-filters 全局StripPrefix / RewritePath 路径变换