把 API 网关做成团队的基础设施

举报
Rolle 发表于 2026/11/15 18:27:06 2026/11/15
【摘要】 当多个团队共用一个网关,它的定位就不再是「某个业务的服务」,而是「公司的基础设施」。这时候需要考虑治理,而不是功能。

当多个团队共用一个网关,它的定位就不再是「某个业务的服务」,而是「公司的基础设施」。这时候需要考虑治理,而不是功能。

提供规范,而不是强制

给出推荐配置、推荐客户端、推荐的重试策略,但不强推。基础设施的推行阻力从来不在技术上。

因为网关支持模型映射别名,文档里的名字和你实际能调的名字可能不是同一个。

一个起码的 .env + .gitignore 组合是底线;如果要同步给团队,用密钥管理工具,而不是共享文档。

配额是治理的主要手段

用 Key 级额度和并发上限做资源分配,比发通知函有效得多。规则写在配置里,不在文档里。

「额度」是时间窗口内的总量上限,「限流」是瞬时速率上限,「余额」是账户层面的预付余额。

如果没有 Key 级限流,一个写错循环的脚本就能把共享池子的额度全部吃掉,其他用户跟着受影响。

共享的可观测口径

所有团队的用量、成功率、延迟用同一套指标定义,管理层才看得到真实情况。

健康探测是要真实发请求的,如果这些请求记在某个 Key 名下,管理员看到的用量就会莫名其妙地偏高。

成功率、时间窗口、历史保留时长——这些数字如果口径不透明,看板就失去了参考价值。

权限分级与审计

密钥管理、用户管理这类高危操作只给最小必要的人,并且有审计记录。

谁在什么时候看了哪些数据、改了哪些配置,这类记录在有管理员的系统中是必需的。

而且权限检查必须落在后端:隐藏菜单不能替代授权,列表、详情、聚合、更新、删除每一条路径都要单独检查作用域。

实操:多业务线共用一个网关时,按分组隔离资源。

分组和专属渠道是分配资源配额最灵活的手段。

# 在后台「资源 → Key 分组」里建一个专属分组,
# 把指定的渠道移进去(注意:同一个渠道只要还挂在任何公开分组里,
# 未绑定的 Key 就仍然能用它,所以要从所有公开分组移除)。

# 然后在创建 Key 时选择这个专属分组:
#   → 未绑定分组的 Key:能用所有公开分组里的渠道
#   → 绑定专属分组的 Key:只能用该组渠道
#   → 分组被停用 / 为空:直接拒绝,不回退到公开池

几个容易踩的坑

  • 只实现了 happy path,异常分支一条没测。
  • 把上游凭据明文存库,或者在后台详情里返回完整 Key。
  • 没有做 Key 级限流和并发上限,单个租户就能打满整个池子。
  • 以为「反向代理写完」就是网关做完了。

小结

技术上的事大多不复杂,难的是把每个异常分支都想清楚。把这份清单存下来,下次排障会快不少。

文中的示例接口都可以在 https://aiminis.info/ 上直接验证,用量与额度在用户中心 https://aiminis.info/console 随时可查。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。