统一 API 网关平台

电子商务 B2C 案例ID：245644

15 年经验· mdcl

微信扫码沟通，客服可协助直接对接工程师；如当前档期不合，也可继续推荐相似案例作者。

案例介绍

## 核心过滤器
| 过滤器 | Order | 职责 |
| AuthGlobalFilter | -100 | JWT 校验、黑名单检查、用户封禁、透传 userId/roles |
| RateLimitFilter | 0 | Sentinel 三层限流（接口/用户/IP）、自定义降级响应 |
| GrayReleaseFilter | 10 | Header/Cookie/权重三种灰度分流策略 |
| RequestLoggingFilter | MAX | TraceId 注入、耗时统计、慢请求告警 |

关键技术点
1. 统一鉴权（无状态）
- JWT 签发后服务端不存储，网关解析后透传 userId 给下游
- 下游服务无需重复解析 token
- Token 黑名单（Redis）支持主动踢人 / 退出登录
- 即将过期自动通知前端续期（Response Header: X-Renew-Token）

2. 精细化限流
L1 接口级**：/api/order/** → 5000 QPS
L2 用户级**：单用户 100 QPS（热点参数限流）
L3 IP 级**：单 IP 50 QPS
限流规则持久化到 Nacos，Sentinel 控制台实时调整

### 3. 灰度发布
Header 标记：`X-Gray-Release: true`
Cookie 白名单：`gray_user=1`
权重分流：10% 流量到灰度服务
修改下游服务名：`order-service` → `order-service-gray`

### 4. 全链路追踪
网关生成/透传 TraceId → Response Header + 日志 MDC
配合 SkyWalking / Sleuth 实现分布式链路追踪
慢请求自动告警（> 1000ms）
## 监控指标
| 指标 | 来源 | 用途 |
| QPS / RT / 错误率 | Prometheus + Actuator | Grafana 大盘 |
| 限流/熔断触发次数 | Sentinel Dashboard | 容量规划 |
| 各路由请求量分布 | Gateway Metrics | 流量分析 |
| 慢请求列表 | 日志 → ELK | 性能优化 |