把 API 网关做成团队的基础设施
当多个团队共用一个网关,它的定位就不再是「某个业务的服务」,而是「公司的基础设施」。这时候需要考虑治理,而不是功能。
提供规范,而不是强制
给出推荐配置、推荐客户端、推荐的重试策略,但不强推。基础设施的推行阻力从来不在技术上。
因为网关支持模型映射别名,文档里的名字和你实际能调的名字可能不是同一个。
一个起码的 .env + .gitignore 组合是底线;如果要同步给团队,用密钥管理工具,而不是共享文档。
配额是治理的主要手段
用 Key 级额度和并发上限做资源分配,比发通知函有效得多。规则写在配置里,不在文档里。
「额度」是时间窗口内的总量上限,「限流」是瞬时速率上限,「余额」是账户层面的预付余额。
如果没有 Key 级限流,一个写错循环的脚本就能把共享池子的额度全部吃掉,其他用户跟着受影响。
共享的可观测口径
所有团队的用量、成功率、延迟用同一套指标定义,管理层才看得到真实情况。
健康探测是要真实发请求的,如果这些请求记在某个 Key 名下,管理员看到的用量就会莫名其妙地偏高。
成功率、时间窗口、历史保留时长——这些数字如果口径不透明,看板就失去了参考价值。
权限分级与审计
密钥管理、用户管理这类高危操作只给最小必要的人,并且有审计记录。
谁在什么时候看了哪些数据、改了哪些配置,这类记录在有管理员的系统中是必需的。
而且权限检查必须落在后端:隐藏菜单不能替代授权,列表、详情、聚合、更新、删除每一条路径都要单独检查作用域。
实操:多业务线共用一个网关时,按分组隔离资源。
分组和专属渠道是分配资源配额最灵活的手段。
# 在后台「资源 → Key 分组」里建一个专属分组,
# 把指定的渠道移进去(注意:同一个渠道只要还挂在任何公开分组里,
# 未绑定的 Key 就仍然能用它,所以要从所有公开分组移除)。
# 然后在创建 Key 时选择这个专属分组:
# → 未绑定分组的 Key:能用所有公开分组里的渠道
# → 绑定专属分组的 Key:只能用该组渠道
# → 分组被停用 / 为空:直接拒绝,不回退到公开池
几个容易踩的坑
- 只实现了 happy path,异常分支一条没测。
- 把上游凭据明文存库,或者在后台详情里返回完整 Key。
- 没有做 Key 级限流和并发上限,单个租户就能打满整个池子。
- 以为「反向代理写完」就是网关做完了。
小结
技术上的事大多不复杂,难的是把每个异常分支都想清楚。把这份清单存下来,下次排障会快不少。
文中的示例接口都可以在 https://aiminis.info/ 上直接验证,用量与额度在用户中心 https://aiminis.info/console 随时可查。
- 点赞
- 收藏
- 关注作者
评论(0)