架构与系统设计 / 系统课时

什么时候该引入 API Gateway

什么时候该引入 API Gateway

API Gateway 的价值不在于“多加一层”,而在于把多个客户端都需要的入口能力集中到边缘。本篇从认证、路由、限流、聚合和治理成本出发,判断网关何时值得引入,并用最小配置验证它应承担的边界。

学习目标

  • 识别适合放在 API Gateway 的横切能力
  • 判断小型系统中网关是否会变成不必要的复杂度
  • 用路由与限流配置验证“统一入口、业务下沉”的边界

先判断你是否真的有入口治理问题

如果系统只有一个 Web 客户端和一个单体服务,直接由负载均衡器把流量转给应用通常更简单。此时引入独立网关会增加一次转发、配置面、部署单元和故障点,却没有足够的复用收益。

当客户端类型增多、后端服务拆分、每个入口都重复实现认证、限流、路由或观测时,网关才开始有明显价值。它解决的是客户端到服务集群之间的统一入口问题,不是服务内部所有通信问题。

一个实用判断是:如果没有网关,你是否会在多个服务或多个客户端边缘重复维护同一套策略?答案越接近“会”,引入网关的收益越明确。

网关应该负责哪些事情

适合放进 API Gateway 的能力通常具有“与具体业务弱相关、多个接口都要复用”的特征,例如统一 TLS 终止、身份令牌校验、路由、限流、请求大小限制、基础日志、追踪标识和协议转换。

请求聚合也可以放在网关,但要克制。移动端若为了一个页面必须并行请求五六个后端接口,网关或专门的 BFF 可以做轻量聚合;如果聚合开始包含复杂库存规则、订单状态机或跨库事务,它已经越过入口层边界,应回到业务服务或编排层。

API Gateway 的位置与职责边界

用收益和代价做判断

现象 是否支持引入网关 原因
多种客户端访问多个后端服务 强 统一入口可隐藏内部服务拓扑
多个服务重复实现认证、限流、审计 强 横切策略集中后更易一致治理
只有一个简单单体服务 弱 新增层次通常大于收益
需要复杂领域编排或事务 弱 这不是入口网关应承担的职责
需要按路径、租户或版本做流量控制 强 网关适合统一执行边缘流量策略

引入网关后还要主动回答它自己的可靠性问题:是否多实例部署、是否有健康检查、配置如何发布和回滚、限流状态是否依赖外部存储,以及网关故障时会影响多大范围。网关统一了入口,也因此扩大了入口故障的爆炸半径。

用最小配置验证职责边界

下面用 NGINX 演示一个最小入口:网关只做按路径路由、每 IP 限流和请求标识传递,不包含订单或用户领域逻辑。假设用户服务监听 127.0.0.1:8081,订单服务监听 127.0.0.1:8082。

nginx
events {}

http {
    limit_req_zone $binary_remote_addr zone=api_per_ip:10m rate=10r/s;

    upstream users {
        server 127.0.0.1:8081;
    }

    upstream orders {
        server 127.0.0.1:8082;
    }

    server {
        listen 8080;

        location /api/users/ {
            limit_req zone=api_per_ip burst=20 nodelay;
            proxy_set_header X-Request-ID $request_id;
            proxy_pass http://users;
        }

        location /api/orders/ {
            limit_req zone=api_per_ip burst=20 nodelay;
            proxy_set_header X-Request-ID $request_id;
            proxy_pass http://orders;
        }
    }
}

这份配置的生效行为是:客户端只访问 8080,网关依据路径选择上游,并在进入后端前统一执行限流。它没有替后端决定“用户是否能退款”之类的领域规则。

把配置保存为当前目录的 nginx.conf 后,可以先做语法验证:

bash
nginx -t -c "$(pwd)/nginx.conf"

预期输出如下,实际路径会因环境不同而变化:

text
nginx: the configuration file <PATH> syntax is ok
nginx: configuration file <PATH> test is successful

不要把网关变成新的单体

网关最常见的反模式,是因为“所有请求都经过这里”就不断加入业务判断,最后形成一个必须理解所有领域的超级入口。这样既让每次业务改动都要发布网关,也会让团队边界重新耦合。

在系统设计面试中,可以把结论落到一个清晰原则:跨服务复用的入口策略上收,领域决策下沉到服务。当统一入口能显著减少重复治理、隐藏内部拓扑并提供一致流量控制时,引入 API Gateway;当系统仍然很小或需求主要是业务编排时,保持架构简单通常更好。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

什么时候该引入 API Gateway

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通