网关自定义过滤器开发实践
Spring Cloud Gateway 基于 WebFlux 的响应式架构，比 Zuul 1.x 性能更好。本文从路由规则到自定义过滤器，一步步搭建生产可用的网关。
一、网关的核心职责
- 1.1 路由转发——请求分发到对应的微服务
- 1.2 统一鉴权——Token 校验、权限控制
- 1.3 限流——基于 Redis 的令牌桶
- 1.4 日志/监控——请求日志、调用链
- 1.5 协议转换——HTTP → gRPC / WebSocket
二、Spring Cloud Gateway 核心概念
- 2.1 Route——路由，ID + URI + Predicates + Filters
- 2.2 Predicate——断言，匹配请求条件
- 2.3 Filter——过滤器，对请求/响应做修改
- 2.4 整体架构——基于 Netty + WebFlux，非阻塞
三、路由配置
- 3.1 YAML 配置方式——
spring.cloud.gateway.routes - 3.2 Java DSL 配置方式——
RouteLocatorBuilder - 3.3 动态路由——从 Nacos 配置中心获取
- 3.4
Path/Host/Header/Method等断言
四、内置过滤器
- 4.1
AddRequestHeader/AddRequestParameter - 4.2
StripPrefix——去除路径前缀 - 4.3
RewritePath——路径重写 - 4.4
RequestRateLimiter——基于 Redis 的限流
五、自定义过滤器开发
- 5.1 GlobalFilter——全局过滤器
- 5.2 GatewayFilter——局部过滤器
- 5.3 开发统一鉴权过滤器——
AuthGlobalFilter - 5.4 开发请求日志过滤器——
LoggingGlobalFilter - 5.5 过滤器顺序——
@Order或Ordered接口
六、自定义断言
- 6.1
AbstractRoutePredicateFactory的实现 - 6.2 开发一个自定义断言——按时间段路由
七、生产环境实践
- 7.1 跨域配置——
CorsConfiguration - 7.2 超时与重试——
spring.cloud.gateway.httpclient - 7.3 优雅停机——
gracefulShutdown - 7.4 网关高可用——多实例 + Nginx
八、总结
- Gateway vs Zuul vs Nginx/Kong 的选型
- 什么时候需要在网关层处理 vs 在服务层处理
本博客所有文章除特别声明外，均采用 CC BY-NC-SA 4.0 许可协议。转载请注明来源 谜思录！
相关推荐
2022-10-15
并发工具类对比与实践
一个接口需要调用 3 个微服务，串行 300ms。用 CompletableFuture 并行调用只需 120ms。 一、场景描述 1.1 商品详情页——需要商品信息、库存、评价、推荐 1.2 串行调用——逐个等待，时间累加 1.3 并行调用的收益——总时间 = max(每个调用的时间) 二、CountDownLatch 2.1 原理——计数器，主线程等待所有子任务完成 2.2 代码示例——3 个线程并行获取数据 2.3 缺点——无法获取返回值、只能使用一次 三、CyclicBarrier 3.1 原理——所有线程到达 barrier 后一起继续 3.2 与 Count...
2024-12-01
Function Calling 实践
“帮我查一下北京今天的天气” → 大模型不会查天气，但可以调用你的 API。Function Calling 让 AI 与业务系统打通。 一、Function Calling 是什么 1.1 本质——大模型输出函数调用请求，程序执行后返回结果 1.2 流程——用户输入 → 模型决定调用哪个函数 → 程序执行 → 模型生成最终答案 1.3 与 Agent 的关系——Function Calling 是 Agent 的基础能力 二、定义 Function 2.1 函数描述——用 JSON Schema 定义 2.2 参数描述——告诉模型每个参数的含义 2.3 Spring AI 的 @...
2015-01-17
Spring 事务失效场景与原因分析
“@Transactional 怎么不生效？” 这个问题被问了无数遍。本文总结 8 个事务失效场景，每个都有代码复现和修正方案。 一、事务不生效的总根源 1.1 Spring 事务是 AOP 代理实现的 1.2 所有失效原因最终都归结为”代理没有生效”或”异常没有触发回滚” 二、场景 1：非 public 方法 2.1 原理——CGLIB 无法代理 private/protected 方法 2.2 错误示例与修正 三、场景 2：自调用问题 3.1 同类中方法 A 调用方法 B，B 的事务失效 3.2 解决方案——AopContext.currentProxy() 或拆分...
2016-03-12
Redis 分布式锁实现方案
从最简单的 SETNX 到 Redisson 的看门狗机制，再到 RedLock 算法，分布式锁的演进中包含了多少并发安全的设计思想。 一、分布式锁的核心要求 1.1 互斥性——同一时刻只有一个客户端持有锁 1.2 防死锁——锁的持有者崩溃后锁能被释放 1.3 解铃还须系铃人——谁加的锁只能谁来解 1.4 可重入性——同一客户端可重复获取 二、V1：SETNX + EXPIRE 的原子性问题 2.1 SETNX key value + EXPIRE key ttl——两步不是原子的 2.2 在 SETNX 和 EXPIRE 之间崩溃 → 死锁 2.3 Redis 2.6.12 之前...
2013-01-12
线上 Full GC 频繁问题排查
凌晨告警群炸了——接口响应超时，服务器 CPU 飙到 300%。登录一看，Full GC 每 5 秒一次。本文还原完整的排查和修复过程。 一、告警与现场 1.1 从监控看异常——CPU 飙升、接口 RT 暴涨、GC 频率异常 1.2 保留现场的三板斧——jstack / jmap / jstat 二、GC 日志解读 2.1 开启 GC 日志 -Xlog:gc*（JDK 9+）vs -XX:+PrintGCDetails（JDK 8） 2.2 GC 日志字段逐一解析 2.3 GC Easy / GC Viewer 可视化分析 2.4 案例日志：每 5 秒...
2026-06-13
大模型应用性能优化
大模型 API 调用慢（2-5 秒）、贵（按 Token 计费），如何在保证效果的前提下优化性能和成本？ 一、大模型应用的性能瓶颈 1.1 延迟——大模型推理本身慢 1.2 成本——每次都调 API 很贵 1.3 吞吐——API 有并发限制 二、语义缓存（Semantic Cache） 2.1 原理——相似的问题，答案也相似 2.2 不是精确匹配——余弦相似度 > 0.95 就复用 2.3 Redis + Embedding 实现 2.4 Spring AI 的缓存支持 2.5 缓存命中率和成本节省 三、SSE 流式响应 3.1 普通调用——等 5 秒，一次性返回 3.2 ...