深入理解 API 网关

什么是 API 网关

API 网关（API Gateway）是微服务架构中的核心组件，位于客户端与后端服务之间，充当所有请求的统一入口。它负责请求路由、协议转换、安全认证、流量控制等功能，让后端服务专注于业务逻辑本身。

1
2
3

客户端 → API 网关 → 服务 A
                 → 服务 B
                 → 服务 C

为什么需要 API 网关

在没有网关的微服务架构中，客户端需要直接调用各个服务，会带来以下问题：

• 地址管理复杂：客户端需要维护每个服务的地址
• 重复逻辑：鉴权、限流等逻辑在每个服务中重复实现
• 暴露内部结构：服务拆分细节对外暴露，耦合度高
• 跨域问题难处理：每个服务都要单独配置

API 网关将这些横切关注点统一处理，后端服务只需关注业务。

核心功能

1. 路由转发

网关根据请求路径、Header、域名等规则，将请求转发到对应的后端服务。

1
2
3
4
5
6
7

routes:
  - path: /api/user/**
    service: user-service
  - path: /api/order/**
    service: order-service
  - path: /api/product/**
    service: product-service

2. 负载均衡

网关内置负载均衡，将请求分发到服务的多个实例，常见策略：

3. 身份认证与授权

网关统一处理 JWT、OAuth2、API Key 等认证方式，后端服务无需重复鉴权。

1
2
3

请求 → 网关（验证 Token） → 后端服务（携带用户信息）
         ↓ Token 无效
       返回 401

4. 限流与熔断

限流防止流量洪峰压垮服务，常见算法：

• 令牌桶：以固定速率生成令牌，允许一定程度的突发
• 漏桶：以固定速率处理请求，严格平滑流量
• 滑动窗口：统计滑动时间窗口内的请求数

熔断在下游服务异常时快速失败，避免故障扩散：

1
2
3

正常 → 半开（探测） → 正常
         ↓ 失败率超阈值
        熔断（直接返回错误）

5. 协议转换

网关可以在不同协议间转换，例如：

• HTTP → gRPC
• WebSocket → HTTP
• REST → GraphQL

6. 请求/响应改写

• 添加或删除 Header
• 修改请求路径
• 聚合多个服务的响应（BFF 模式）

常见网关产品对比

网关的部署模式

单层网关

1

客户端 → 网关 → 后端服务

简单直接，适合中小规模系统。

两层网关（边缘网关 + 内部网关）

1

客户端 → 边缘网关（安全、限流）→ 内部网关（路由、服务发现）→ 后端服务

边缘网关负责外部流量治理，内部网关负责服务间调用，职责分离更清晰。

BFF（Backend For Frontend）

1
2
3

移动端 → BFF 网关 A ↘
Web 端  → BFF 网关 B → 后端服务
IoT 端  → BFF 网关 C ↗

为不同客户端定制聚合层，减少客户端请求次数。

性能优化要点

网关处于请求链路关键位置，性能至关重要：

1. 异步非阻塞 I/O：使用 Netty、Nginx 事件驱动模型，避免线程阻塞
2. 连接池复用：与后端服务保持长连接，减少连接建立开销
3. 本地缓存：缓存路由规则、Token 验证结果，减少重复计算
4. 避免同步调用：插件逻辑尽量异步，不阻塞请求主流程
5. 合理超时设置：为每个后端服务设置独立超时，防止慢服务拖垮网关

总结

API 网关是微服务架构的流量入口，核心价值在于将横切关注点从业务服务中剥离，集中管理。选型时需结合团队技术栈、性能要求和运维能力综合考量。对于大流量系统，网关本身也需要做好高可用部署（多实例 + 健康检查），避免单点故障。