3. 网关路由与流量分发：基于请求特征的动态路由策略、灰度发布与蓝绿部署在风控网关中的实现

3.1 风控网关路由的核心挑战

风控网关不同于通用 API 网关，其路由决策不仅依赖 URL 或 Header，更依赖请求携带的业务特征（用户 ID、设备指纹、IP 归属地、交易金额等）。传统静态路由（如 Nginx location 匹配）无法满足以下需求：

• 特征维度路由：根据用户风险等级、渠道来源、业务类型将请求分发到不同模型服务版本。
• 动态权重调整：模型上线后需要实时调整流量比例，无需重启网关。
• 灰度与蓝绿部署：新模型版本先承接小流量验证，确认稳定后再全量切换。
• 故障隔离：当某个模型服务实例异常时，自动将流量路由到健康实例。

3.2 基于请求特征的动态路由策略

3.2.1 路由特征提取与匹配

动态路由的核心是特征-规则引擎。网关在接收到请求后，从请求体中提取预定义的特征字段，与路由规则表中的条件进行匹配，决定目标模型服务集群。

3.2.2 路由规则数据结构

路由规则采用优先级有序列表存储，支持精确匹配、范围匹配、正则匹配和哈希分桶。以下为规则表示例：

{
  "rules": [
    {
      "id": "rule_001",
      "priority": 100,
      "conditions": [
        {"field": "amount", "operator": "gt", "value": 10000},
        {"field": "channel", "operator": "eq", "value": "online_pay"}
      ],
      "target": "model_cluster:high_risk_v2",
      "weight": 100
    },
    {
      "id": "rule_002",
      "priority": 90,
      "conditions": [
        {"field": "user_id", "operator": "hash_mod", "value": {"mod": 100, "range": [0, 5]}}
      ],
      "target": "model_cluster:experimental_v3",
      "weight": 100
    },
    {
      "id": "rule_default",
      "priority": 0,
      "conditions": [],
      "target": "model_cluster:stable_v1",
      "weight": 100
    }
  ]
}

3.2.3 动态路由流程图

下图展示了风控网关基于请求特征的动态路由完整流程：

3.3 灰度发布在风控网关中的实现

3.3.1 灰度策略设计

风控模型的灰度发布需要精细控制，避免因模型缺陷导致大面积误杀或漏过。常见的灰度策略包括：

• 用户 ID 哈希分桶：对 user_id 取模，将特定百分比的用户流量导入灰度版本。适合用户级灰度。
• 业务比例采样：按请求总数百分比随机采样，适合无状态请求。
• 白名单/黑名单：指定特定用户、设备或 IP 走灰度版本，用于内部测试或定向验证。
• 地域/渠道灰度：先开放某个地域或渠道的流量，验证模型在该场景下的表现。

3.3.2 灰度流量路由实现

在网关中，灰度路由通过权重动态调整实现。每个模型版本对应一个权重值，网关根据权重比例将请求分发到不同版本。权重值存储在配置中心，支持实时修改。

// 灰度路由伪代码
function routeByGrayScale(request, versions) {
    // versions: [{id: "v1", weight: 90}, {id: "v2", weight: 10}]
    let hash = hashRequest(request); // 基于 user_id 或 request_id 的哈希
    let totalWeight = versions.reduce((sum, v) => sum + v.weight, 0);
    let target = hash % totalWeight;
    let cumulative = 0;
    for (let v of versions) {
        cumulative += v.weight;
        if (target < cumulative) {
            return v.id;
        }
    }
    return versions[versions.length - 1].id;
}

3.3.3 灰度发布流程

1. 部署灰度版本：在目标集群中部署新模型版本实例，但不接入流量。
2. 配置灰度规则：在配置中心设置灰度比例（如 5%），网关自动加载新规则。
3. 监控与验证：观察灰度版本的延迟、准确率、拒绝率等指标，与基线版本对比。
4. 逐步放量：根据监控结果，逐步提高灰度比例（10% → 30% → 50% → 100%）。
5. 全量切换：灰度版本验证通过后，将全部流量切换到新版本，下线旧版本。

3.4 蓝绿部署在风控网关中的实现

3.4.1 蓝绿部署原理

蓝绿部署维护两套完全独立的模型服务集群：蓝集群（当前生产版本）和绿集群（新版本）。网关通过路由规则一键切换流量，实现零宕机发布。

3.4.2 蓝绿部署在网关中的实现

风控网关通过路由目标动态切换实现蓝绿部署。网关维护一个活跃集群标识（active_cluster），路由规则中的 target 字段指向该标识对应的集群地址。

// 蓝绿部署配置示例
{
  "blue_cluster": {
    "name": "model_blue",
    "endpoints": ["10.0.1.1:8080", "10.0.1.2:8080"],
    "health_check": "/health"
  },
  "green_cluster": {
    "name": "model_green",
    "endpoints": ["10.0.2.1:8080", "10.0.2.2:8080"],
    "health_check": "/health"
  },
  "active_cluster": "blue",  // 当前活跃集群
  "switch_strategy": "immediate"  // 切换策略：immediate / gradual
}

3.4.3 蓝绿部署流程图

下图展示了蓝绿部署在风控网关中的流量切换过程：

3.5 灰度与蓝绿部署的融合实践

在实际风控场景中，灰度发布和蓝绿部署往往结合使用，形成多阶段发布流程：

1. 内部验证阶段：在绿集群上部署新版本，通过白名单路由让内部测试人员访问。
2. 灰度阶段：在绿集群上设置灰度权重（如 5%），通过用户哈希分桶引入生产流量。
3. 蓝绿切换阶段：灰度验证通过后，将 active_cluster 从蓝切换到绿，全量承接流量。
4. 观察与回滚：切换后持续监控，若发现问题立即切回蓝集群。

3.6 路由与分发的可观测性

为了保障路由决策的正确性和灰度/蓝绿部署的安全性，网关需要暴露以下指标：