请求限流

请求限流用于控制异常流量，保护配额和服务稳定性。GEELAB 将流量控制下放到接入端，让你可以针对不同平台和业务入口分别设置规则。

接入端分钟/小时限流

接入端限流针对单个 Web、iOS 或 Android 接入端设置，通常包含：

• 每分钟最大请求数。
• 每小时最大请求数。

设置时应根据正常峰值预留余量。每分钟限制乘以 60 不应高于每小时限制。

例如，如果正常峰值为每分钟 100 次，可以先根据业务波动设置一个更高的测试阈值，再通过监控数据逐步调整，而不是直接使用过低的限制。

组织状态与接入端限流

接入端限流只影响当前接入端。组织停用、套餐到期或总配额耗尽时，可能同时影响组织内多个应用和接入端。

超限后的表现

当请求超过接入端限制时：

• GEELAB 拒绝超出限制的请求。
• 客户端可能收到限流相关错误码。
• 通过正常时间窗口后，限制通常自动恢复。
• 应用和接入端的配置不会自动改变。

限流不是永久封禁。请先确认业务是否处于异常峰值，再决定是否调整阈值。

图示：接入端限流配置

限流排查

如果请求已经被拒绝，请继续查看请求被限流或配额耗尽，区分接入端限流与组织额度问题。

如果请求被限流：

1. 记录错误发生时间和 Request ID（如果已生成）。
2. 确认是否只有一个接入端受影响，还是组织状态或套餐额度导致多个接入端同时受影响。
3. 查看接入端每分钟和每小时用量。
4. 查看组织套餐配额和当前用量。
5. 检查是否有异常重试、循环调用或批量任务。
6. 等待下一个时间窗口，确认是否自动恢复。
7. 根据长期流量调整阈值，并保留异常流量防护。

不要为了通过一次测试而永久关闭所有限流。对于 Public API Key 暴露在客户端的应用，至少保留一层合理的流量保护。