📚 课程目录第3章网关核心组件

3. 网关核心组件：路由、过滤器、负载均衡、限流、熔断、鉴权、日志、监控

API 网关作为微服务架构的“前门”，其核心价值在于将非业务功能从业务服务中剥离，统一在网关层处理。一个成熟的 Go 网关（如 Kong、APISIX 或自研网关）通常由八大核心组件构成，它们协同工作，形成请求的完整生命周期管理。

3.1 核心组件全景图

下图展示了请求从进入网关到转发至后端服务的完整链路，以及各组件在链路中的位置与协作关系。

3.2 组件职责与实现要点

每个组件在 Go 网关中都有明确的职责边界和典型的实现模式。下表总结了八大组件的核心功能、常见实现方式及关键考量。

序号	组件	核心职责	Go 实现要点
①	路由	根据请求的 Method、Path、Header 等匹配到对应的上游服务	使用前缀树（Trie）或基数树（Radix Tree）实现高效匹配；支持路径参数、通配符、正则
②	鉴权	验证请求身份，确保只有合法用户才能访问受保护资源	支持 JWT、OAuth2、API Key、Basic Auth 等多种策略；通过插件化接口实现可插拔
③	限流	控制单位时间内的请求数量，防止流量洪峰冲垮后端	基于令牌桶（Token Bucket）或漏桶（Leaky Bucket）算法；使用 Redis 或本地内存实现分布式/单机限流
④	熔断	当后端服务故障率达到阈值时，快速失败，避免级联雪崩	实现三种状态：关闭、打开、半开；基于滑动窗口统计错误率；参考 Hystrix 或 Sentinel 模型
⑤	日志	记录请求/响应的关键信息，用于审计、排障和数据分析	采用结构化日志（JSON 格式）；支持访问日志、错误日志、慢请求日志；异步写入避免阻塞
⑥	负载均衡	将请求分发到多个后端实例，提升系统吞吐和可用性	支持轮询、加权轮询、最少连接、一致性哈希等算法；动态感知后端实例上下线
⑦	过滤器	以链式模式组织预处理和后处理逻辑，实现横切关注点	定义 Filter 接口（PreFilter/PostFilter）；通过责任链模式串联执行；支持条件跳过和中断
⑧	监控	采集网关自身的运行指标和后端服务的健康状态	集成 Prometheus 指标暴露；记录 QPS、延迟、错误率、上游响应时间；支持告警规则配置

3.3 过滤器链：组件的编排核心

过滤器（Filter）是网关中最灵活的组件，它不直接处理业务，而是为请求和响应提供横切能力。在 Go 网关中，过滤器链通常采用责任链模式实现，每个过滤器可以决定是否继续执行下一个过滤器，或者直接中断请求并返回响应。

过滤器链执行顺序示例（Go 伪代码）：

type Filter interface {
    PreFilter(ctx *Context) error   // 请求处理前执行
    PostFilter(ctx *Context) error  // 响应处理后执行
}

// 典型过滤器链配置顺序
filters := []Filter{
    &RateLimitFilter{limit: 100},   // 1. 限流（最先执行）
    &AuthFilter{provider: "jwt"},   // 2. 鉴权
    &CircuitBreakerFilter{},        // 3. 熔断
    &AccessLogFilter{},             // 4. 日志（最后执行）
}

func ExecuteChain(ctx *Context) error {
    for _, f := range filters {
        if err := f.PreFilter(ctx); err != nil {
            return err  // 中断链，返回错误响应
        }
    }
    // 转发到后端
    // ...
    for i := len(filters) - 1; i >= 0; i-- {
        filters[i].PostFilter(ctx)  // 逆序执行后处理
    }
    return nil
}

设计建议：过滤器应保持无状态，所有上下文信息通过 Context 对象传递。限流和鉴权应放在链的前端，尽早拒绝非法请求；日志应放在链的末端，确保记录完整的请求生命周期。

3.4 限流与熔断的协同策略

限流和熔断虽然都是保护机制，但作用层面不同。限流是主动防御，在流量到达后端之前进行控制；熔断是被动恢复，在后端已经出现故障时快速止损。两者需要协同配置才能发挥最大效果。

3.5 监控与日志：可观测性的基石

监控和日志是网关运维的“眼睛”。没有有效的可观测性，网关的故障定位和性能优化将无从下手。在 Go 网关中，这两者通常通过以下方式实现：

指标采集：使用 Prometheus 客户端库（prometheus/client_golang）暴露 Histogram（延迟分布）、Counter（请求总数、错误数）、Gauge（当前连接数）等指标。
结构化日志：使用 logrus 或 zap 输出 JSON 格式日志，包含 request_id、latency、status_code、upstream_addr 等关键字段。
链路追踪：集成 OpenTelemetry，将 trace_id 透传到后端服务，实现全链路追踪。

常见陷阱：日志和监控的采集不应影响网关的核心转发性能。务必使用异步写入、缓冲队列和采样策略。对于高并发场景，建议将日志写入本地文件，再由 Filebeat 等工具采集，避免直接网络写入成为瓶颈。

3.6 组件配置示例（YAML）

在实际的 Go 网关项目中，上述组件通常通过配置文件进行声明式管理。以下是一个简化的配置示例：

# gateway-config.yaml
routes:
  - id: user-service
    uri: /api/v1/users/*
    upstream:
      service: user-svc
      port: 8080
    filters:
      - name: rate-limit
        args:
          rate: 100
          burst: 200
      - name: auth
        args:
          type: jwt
          secret: "my-secret-key"
      - name: circuit-breaker
        args:
          error_threshold: 50
          timeout: 30s
      - name: access-log
        args:
          format: json
    load_balance:
      algorithm: least_connections
    metrics:
      enabled: true
      path: /metrics

通过这种配置方式，运维人员可以灵活调整每个路由的组件行为，而无需修改网关代码，实现了配置与代码的分离，这也是企业级网关的必备能力。