给后端服务加一道统一入口：华为云APIG从创建分组到发布API与限流全实操

一、为什么需要 API 网关

当后端微服务越来越多，直接把每个服务地址暴露给前端会带来一系列问题：调用方要维护一堆地址、鉴权逻辑散落在各服务、没有统一的限流和监控、后端地址变更会牵连所有调用方。API 网关（APIG）就是在客户端和后端服务之间加的一道统一入口，对外暴露稳定的域名和路径，内部再把请求转发到不同的后端服务，并统一处理鉴权、限流、熔断、日志和监控。

二、创建 API 分组

在 APIG 控制台首先创建一个 API 分组，可以把它理解为一组相关接口的集合。分组创建后系统会分配一个访问域名，同一个分组下的 API 共享这个域名，后续发布也是以分组为单位进行。建议按业务域划分分组，例如把订单相关接口放在一个分组，用户相关接口放在另一个分组，便于管理和独立发布。

三、定义一个 API

进入分组后新建 API，需要配置几类关键信息。第一是前端配置：选择请求方法（GET、POST 等）、填写请求路径（如 /orders/{id}），路径中的花括号部分表示路径参数。第二是后端配置：选择后端类型，常用的有 HTTP/HTTPS（转发到已有的 ECS 或负载均衡地址）、函数工作流（把请求转给 FunctionGraph 处理）和云服务等；再填写后端地址、路径和超时时间。第三是参数定义：声明请求参数位于路径、查询还是 Header，并标记是否必填，网关会据此做基础校验。

四、调试 API

定义完成后先不要急着发布，使用控制台提供的调试功能，填入参数直接发起调用。调试请求会真实转发到后端并把响应状态码、响应头和响应体展示出来，同时给出网关自身的耗时。这一步可以快速确认路径映射、参数透传和后端连通性是否正确，避免把问题带到线上。

五、发布到环境

调试通过后，把 API 发布到具体环境（如 RELEASE 生产环境或 TEST 测试环境）。发布是一个明确的动作，只有发布之后，外部才能通过分组域名访问到该 API；之后如果修改了 API 定义，需要重新发布才会生效。调用地址由分组域名、API 路径和查询参数拼接而成，可以在接口文档中直接给到调用方。

六、配置限流与鉴权

网关的价值很大程度体现在统一治理上。限流方面，可以按 API 或用户设置请求次数阈值，超过阈值的请求直接被网关拒绝，防止突发流量压垮后端。鉴权方面，可以在网关层统一接入 AppKey/AppSecret 认证或 IAM 认证，后端服务就不必各自实现一套签名校验。结合访问日志和监控面板，还能看到每个 API 的调用量、延迟和错误率，便于定位问题。

七、实操小结

整体流程可以概括为「建分组 → 定义 API → 调试 → 发布 → 加治理」。APIG 把入口地址、转发、鉴权和限流收敛到一处，既让调用方拿到稳定统一的接口，也让后端服务更专注于业务本身，是微服务架构里非常实用的一层。