debt(D7): 限流/KeyRing 单进程限制说明 + 生产启动一次性告警

- app.py lifespan:APP_ENV=production 时 logger.warning 提醒进程内 rate-limit/KeyRing 仅单进程有效(不 sys.exit、不引入 Redis) - key_ring.py docstring 补充多 worker 不共享的后果说明 - deps.py 注释已具备(单进程有效,生产前置 Nginx),无需改动
2026-09-21 19:51:41 +08:00
parent 17e99a4f9a
commit d9aeff2114
2 changed files with 12 additions and 1 deletions
@@ -1,7 +1,8 @@
 """API Key 轮换环:多 key 自动切换,遇到限流(429)自动跳过已冷却 key。

 设计:
-  - 进程内纯内存状态(限速是短时状态,无需持久化)
+  - 进程内纯内存状态(限速是短时状态,无需持久化;D7: 多 worker 部署时各进程
+    独立计数、不共享,上游限速额度应按 worker 数分摊,或前置网关统一管理)
  - 单 key 场景零开销:直接透传
  - 多 key 场景:429 时把当前 key 标记冷却(默认 60s),轮转到下一个可用 key
  - 全部 key 都在冷却时:使用最早冷却的那个 key 并等待(退化到单 key 重试)