华为云APIG网关限流策略实操

在微服务架构中，API网关是所有流量的统一入口。一旦某个调用方突发洪峰，或者某个下游服务出现慢响应，流量就可能像潮水一样涌向后端，最终拖垮整个系统。华为云APIG提供的限流策略，正是用来在网关层给流量装上“阀门”：在流量超标时快速拒绝多余请求，保护后端服务，也让不同调用方之间实现相对公平的资源分配。本文结合一次真实的配置过程，讲清楚限流策略怎么配、配额和突发控制怎么理解、不同维度怎么选，以及如何用curl验证效果。

一、为什么要在网关层限流

限流的核心目标不是限制业务增长，而是把不可控的流量变成可控的流量。常见场景有三类：第一，突发流量，例如秒杀、营销活动上线，瞬时请求量是平时的十几倍；第二，个别调用方写了死循环或者重试风暴，不断放大请求量；第三，下游服务容量有限，例如数据库连接数只有几百，网关不限流，后端就会被连接占满。把限流放在网关层的好处是统一、生效快，不需要每个服务各自实现一套限流逻辑，而且可以在不改代码的情况下调整阈值。

二、限流策略的配置步骤

在华为云控制台进入“API网关 APIG”，选择对应的实例和分组，在左侧导航找到“限流策略”，点击创建策略。关键配置项包括：策略名称、限流时间单位、API请求次数上限、是否开启特殊APP或特殊用户流控。以一个订单查询接口为例，我的配置是：每分钟最多允许600次调用，超过后直接返回限流错误；同时为内部压测APP单独设置一个更高的上限，避免压测流量被正常限流规则误伤。配置完成后，还需要把策略绑定到具体的API上：进入API详情，选择“绑定流控策略”，保存并发布到对应环境，策略才会真正生效。只创建不绑定，是新手最容易踩的坑。

三、配额与突发控制的区别

配额和突发控制经常被混淆，但它们管的是两个不同时间尺度的问题。配额是较长周期内的总量上限，例如每天最多调用10万次，适合按套餐售卖的开放API，也适合给不同等级的合作伙伴分层：免费用户每天1万次，付费用户每天100万次。突发控制则是短时间内的速率上限，例如每秒最多100次，它防的是瞬时洪峰。打个比方，配额是水库的总库容，突发控制是出水口的阀门开度。两者通常要配合使用：只设配额不设突发，短时间内仍可能冲垮后端；只设突发不设配额，长期来看调用方可能无限制地消耗资源。APIG还支持按时间单位分别设置上限，分钟、小时、天的粒度可以组合，形成多层防护。

四、不同维度的限流怎么选

APIG的限流可以按多个维度生效，选择维度时要先想清楚“到底要限制谁”。按API限流是最常用的一层，保护单个接口不被打爆；按APP限流适合开放平台场景，限制某一个接入方整体的调用量；按用户限流适合登录态业务，防止单个账号刷接口；按源IP限流适合防爬虫和防恶意扫描。实际项目中，我的做法是分层叠加：API层设一个兜底上限，APP层按合作方等级设配额，IP层再设一个较宽松的防刷阈值。这样既不会因为一个调用方异常而影响所有人，也不会因为单点规则过严而误伤正常业务。需要注意的是，维度越细，策略数量和管理成本越高，初期建议先从API层和APP层做起。

五、用curl验证限流是否生效

配置完成后一定要实测，不要只凭控制台显示“已绑定”就认为生效。最简单的办法是用循环连续调用接口，观察返回码从200变成429的临界点：

for i in $(seq 1 120); do
  curl -s -o /dev/null -w "%{http_code} " \
    -H "X-Apig-Token: YOUR_TOKEN" \
    "https://YOUR_DOMAIN/v1/orders?id=1001"
  echo "第 $i 次"
done

如果策略是每分钟600次，单次循环120次不会触发限流；把循环次数提高到700次左右，就能在日志里看到429返回。验证时还要注意三点：第一，检查返回体是否包含限流相关的错误码和提示信息，确认是网关限流而不是后端报错；第二，分别用不同APP的凭证调用，确认特殊APP的单独上限确实生效；第三，在下一个统计周期开始后重新调用，确认限流自动解除，接口恢复200，避免把临时限流误判为永久故障。

六、常见问题与排障

第一，策略已绑定但没有生效：先确认API是否已重新发布到对应环境，未发布的绑定不会生效；再确认调用走的是该分组和环境，而不是直连后端地址。第二，正常业务被误限：通常是阈值按峰值估算不足，或者统计周期理解错误，例如把“每分钟600次”当成了“每秒600次”。建议先按历史峰值的1.5倍设置，再根据监控逐步收紧。第三，限流后客户端不断重试，形成重试风暴：网关限流要配合客户端退避重试和熔断，返回429后等待一段时间再重试，而不是立即原地重发。第四，多网关或多实例部署时，限流计数是否全局共享：共享版与专享版的实现细节不同，上线前应在目标实例上实测确认。

七、总结

APIG限流策略的实操要点可以归纳为四句话：先在网关层统一限流，不要把压力留给后端；配额管总量，突发管速率，两者配合使用；维度分层叠加，API兜底、APP分级、IP防刷；上线前用curl实测触发点和恢复点，上线后结合监控持续调阈值。把这四点做扎实，网关就能在流量洪峰面前稳住阵脚，业务也能获得更可预期的服务质量。