1. 课程导学与项目背景：实时风控网关的定义、业务价值、课程目标与前置知识

1.1 什么是实时风控网关

实时风控网关是部署在业务系统与外部流量入口之间的安全决策中间层。它不同于传统 API 网关仅做路由、限流和协议转换，而是在每一次 API 请求到达后端服务之前，同步执行毫秒级的风险评估与拦截动作。

核心特征包括：

• 实时性：单次决策延迟 < 50ms，不阻塞业务主流程。
• 可编程规则引擎：支持黑白名单、频率控制、设备指纹、行为画像等策略热加载。
• 全链路上下文：透传请求头、设备信息、用户会话、业务参数到风控模型。
• 降级与熔断：当风控服务超时或异常时，自动切换为放行/拦截模式，保障网关可用性。

1.2 业务价值与适用场景

实时风控网关在金融、电商、社交、游戏等高频交易场景中具有明确的业务价值：

1.3 课程目标

本课程以实战交付为导向，完成一个可运行的实时风控网关 API 发布项目。具体目标如下：

1. 架构设计：掌握网关层风控的通用架构模式，包括请求拦截、规则匹配、决策缓存、异步日志。
2. 规则引擎实现：基于 Groovy/SPEL 实现热插拔规则，支持动态加载与版本回滚。
3. 高性能决策链路：使用本地缓存 + Redis 二级缓存，将单次决策 P99 延迟控制在 30ms 以内。
4. API 发布与治理：通过网关统一发布风控 API，实现流量染色、灰度发布、全链路监控。
5. 可观测性：集成 Prometheus + Grafana 监控大盘，实时展示拦截率、决策耗时、规则命中分布。

1.4 前置知识要求

为顺利跟上课程实战节奏，建议学习者具备以下基础：

1.5 实时风控网关核心架构

下图展示了本课程将要实现的实时风控网关整体架构，包含请求入口、网关层、风控决策引擎、数据存储与监控四层：

1.6 课程实战路线图

整个课程按“基础搭建 → 核心引擎 → 网关集成 → 发布治理 → 可观测性”五阶段推进：

• 阶段一（第 2-5 章）：搭建 Spring Cloud Gateway 基础项目，实现请求拦截与上下文构建。
• 阶段二（第 6-12 章）：实现规则引擎、频率计数器、设备指纹模块，完成单机版风控决策。
• 阶段三（第 13-18 章）：将风控引擎嵌入网关过滤器链，实现同步拦截与异步日志。
• 阶段四（第 19-24 章）：API 发布流程、灰度发布、流量染色、版本管理。
• 阶段五（第 25-30 章）：集成 Prometheus + Grafana，构建拦截大盘与告警规则，压测与调优。