API 网关使用记录：统一入口带来的秩序感（1104 期）

把散落在各处的后端服务统一收到 API 网关后面，记录一下这次整理。

之前的问题是每个服务各自暴露端口，鉴权逻辑各写一份，加一个服务就要在安全组开一个洞。收敛到网关之后，对外只有一个入口，鉴权、限流、日志集中在一层处理，后端服务变纯粹了。

配置上的几个要点：一是环境划分，测试和生产的后端地址用变量区分，发布时只切变量不动路由；二是超时要按后端实际能力设置，网关默认超时偏长，慢请求会把客户端挂住；三是限流策略结合业务配，保护的是后端最弱的那个服务，而不是一刀切。

调试技巧也记一笔：网关返回的错误码要区分清楚是网关层拒绝还是后端返回的，看响应头里的网关标记最准，别在错误的层里排查半天。

整理完的感受是，架构上的秩序感是省时间的大头。入口统一了之后，新增服务的成本从改防火墙变成了点几下页面。文档和协作方面也有记录：网关的 API 文档功能可以直接导出给前端和测试用，接口定义、参数说明、错误码集中在一处，沟通成本明显下降。版本管理上，接口变更先在测试环境验证，确认无误再发布到生产，网关层的环境隔离让这个流程变得很轻。初期多花在整理上的时间，后面都会从维护效率里赚回来。