网关API功能性能与交付验收测试 - 第1节
1.1 API 网关的定义
API 网关（API Gateway）是位于客户端与后端微服务集群之间的统一入口层，负责接收所有外部请求，进行协议转换、路由分发、安全校验、流量控制等预处理，再将请求转发至对应的微服务实例。从网络架构视角看，API 网关是系统对外的“大门”，也是微服务架构中南北向流量的核心管控点。
核心定义要点：
- 统一入口：所有客户端（Web、移动端、IoT）通过单一地址访问后端服务。
- 请求代理：将外部请求路由到内部微服务，隐藏服务实例细节。
- 横切关注点：将认证、限流、日志、监控等通用能力从业务服务中剥离，集中到网关层。
- 协议适配：支持 HTTP/HTTPS、gRPC、WebSocket 等多种协议间的转换。
1.2 API 网关的核心价值
在微服务架构中，API 网关并非可有可无的组件，而是解决分布式系统复杂性的关键基础设施。下表总结了网关带来的主要价值维度：
| 价值维度 | 说明 | 典型场景 |
|---|---|---|
| 安全防护 | 集中管理认证、授权、防攻击（如 SQL 注入、DDoS） | OAuth2.0 令牌校验、IP 黑白名单 |
| 流量治理 | 限流、熔断、降级、重试，保障后端服务稳定性 | 突发流量削峰、慢调用熔断 |
| 协议转换 | 将外部协议（如 HTTP）转为内部 RPC 协议（如 gRPC） | 移动端 HTTP 请求转内部 Dubbo 调用 |
| 聚合编排 | 将多个微服务的响应合并为一个结果返回给客户端 | 商品详情页聚合商品、库存、评价服务 |
| 运维简化 | 统一日志、监控、链路追踪接入点 | 全链路 TraceId 注入、访问日志集中采集 |
| 版本管理 | 支持灰度发布、蓝绿部署、API 版本路由 | v1/v2 版本按权重分流 |
交付验收提示： 在验收网关项目时，应逐项核对上述价值点是否已通过配置或插件实现。例如，限流策略是否可动态调整、认证插件是否支持 JWT 和 OAuth2.0 双模式。
1.3 在微服务架构中的位置
API 网关位于微服务架构的接入层，处于客户端与业务微服务之间，同时与注册中心、配置中心、监控系统等基础设施紧密协作。下图展示了网关在典型微服务部署中的位置关系：
1.3.1 网关与周边系统的协作关系
API 网关并非孤立运行，它与微服务架构中的多个基础设施组件形成协作闭环：
- 注册中心：网关从注册中心（如 Nacos、Consul）动态获取服务实例列表，实现服务发现与健康检查。
- 配置中心：网关的路由规则、限流阈值、认证策略等配置统一存储在配置中心（如 Apollo、Nacos Config），支持热更新。
- 监控系统：网关上报请求量、延迟、错误率等指标到 Prometheus + Grafana，用于实时监控与告警。
- 日志中心：网关生成结构化访问日志，通过 Filebeat 或 Fluentd 采集到 ELK 或 Loki 中，用于问题排查。
- 链路追踪：网关作为 Trace 起点，生成全局 TraceId，传递给下游微服务，实现全链路追踪（如 SkyWalking、Jaeger）。
常见交付误区： 部分项目在验收时只关注网关的路由转发功能，忽略了与注册中心、配置中心的集成验证。这会导致后续运维中网关无法自动感知服务扩缩容，或配置变更需要重启生效。验收时必须包含“网关与基础设施集成”的测试用例。
1.4 网关在微服务架构中的职责边界
明确网关的职责边界，有助于在交付验收时合理划分测试范围。下表对比了网关层与业务服务层的典型职责：
| 职责领域 | API 网关层 | 业务微服务层 |
|---|---|---|
| 安全 | 令牌校验、IP 黑白名单、防重放攻击 | 业务权限校验、数据级权限 |
| 流量控制 | 全局/用户级限流、熔断、降级 | 业务逻辑中的局部限流（如库存扣减） |
| 协议处理 | HTTP ↔ gRPC 转换、请求/响应格式适配 | 业务协议（如订单状态机） |
| 路由 | 按路径、Header、权重路由到不同服务 | 服务内部的路由（如分库分表） |
| 日志监控 | 统一访问日志、请求指标采集 | 业务日志、业务指标 |
| 缓存 | 响应缓存（针对幂等查询） | 业务数据缓存（如 Redis 缓存商品信息） |
验收要点： 网关层不应包含任何业务逻辑（如订单金额计算、用户积分增减）。如果验收时发现网关代码中存在业务判断，应视为架构设计缺陷，要求整改。