代理请求自动重试次数和间隔如何根据错误类型设置
代理 IP 请求的重试次数没有通用答案。按错误是否幂等、是否可能已执行定次数上限,按对方给的等待依据定间隔,再给总预算和人工升级各设上限。
代理请求没有一套适用于所有场景的重试次数。连接超时、限流和认证失败的处理方式不同;还要看请求是否幂等,以及目标端是否可能已经执行。先按错误类型设上限,再依据服务端的等待信息安排间隔,并给总耗时和人工介入设边界。
如何按错误类型设置重试次数和间隔?
下面的表格是决策模板。实际取值要按具体接口的幂等能力、状态查询方式和重试约定来定,不能照搬通用次数。
六类常见错误分别如何处理
| 错误类型 | 次数上限看什么 | 间隔看什么 | 什么时候放弃 |
|---|---|---|---|
| 连接中断、超时 | 操作是否幂等、是否可能已执行 | 按接口约定或 Retry-After;没有依据时暂停并复核 | 查不到状态就转人工 |
| 认证失败(凭据、鉴权) | 不重试 | — | 立即停止,核验配置 |
| 限流(429 等) | 先确认接口语义及请求是否可能已产生副作用 | Retry-After 或接口说明 | 无法确认安全重试时先暂停 |
| 业务拒绝(403、校验失败) | 不重试 | — | 按目标站规则人工判断 |
| 服务端错误(5xx) | 语义是否明确 | 逐步拉长,加抖动 | 预算用完仍失败则标记 |
| 未知错误 | 默认不重试 | — | 转人工 |
超时和连接拒绝等网络错误的判别细节,可参照代理 timeout、connection refused 和 TLS 证书错误排查。
表中每一格写的是判断依据,而不是「三次」「五分钟」这类具体数值。系统、对方站点和业务契约各不相同,这些依据要落到自己这套环境里取值。接入参数与账号侧问题可查 全球代理 FAQ,错误码与出口排查可参考 代理 IP 故障排查中心。
认证类错误(407)和限流(429)最容易与网络错误混在一起,但处理方向相反:前者要停下来核验,后者要按对方给的等待时间退让,都不能靠增加重试次数解决。
没有通用重试次数,应依据哪些信号判断?
- 幂等性:重发一次的效果,是否和只发一次相同。不幂等的操作,次数上限只能靠状态确认,不能靠次数。
- 对方的等待要求:429 或维护提示里给的等待时间优先于任何自定间隔;
Retry-After允许秒数和绝对时间两种写法,语义见 RFC 9110 §10.2.3。 - 站点文档与接口契约:对方明确写了重试节奏的,按对方写的来。
- 自己的预算:单条次数、一轮总时长、并发,三者任一耗尽都必须停下。
- 退避与抖动:间隔要拉长,并加随机抖动,避免所有任务在同一秒重试。
退避不是「多等一会」这么简单:它的作用是把重试压力摊开。没有抖动,几百个任务会在同一时刻重新涌上去。
预算用完了,任务算成功还是失败
如何计算总重试预算?
重试耗时应由每次请求的超时上限和各次退避等待时间相加估算,次数本身不能代表总耗时。并发数决定同时在途请求量,任务数及每个任务的请求量决定总请求量。设定单个任务的预算前,应核对目标站限流规则和系统容量。上限由目标站规则和已批准配额决定,系统容量只决定「能不能跑得动」。
预算耗尽后,明确选择停止、标记或转人工
预算用完之后的收尾,是最容易被含糊处理的一步:
| 收尾方式 | 适用 | 要注意 |
|---|---|---|
| 标记失败 | 明确失败、可重跑 | 批次记录要能筛出失败项 |
| 转人工 | 结果未知、有副作用 | 保留操作 ID 与现场 |
| 下一轮重跑 | 明确未执行 | 不能与已成功的批次混在一起 |
静默放弃是唯一不能选的方式:任务显示成功,实际漏了一批,等到下游对不上数才发现。更前置的「哪些错误不该重试」的判断,见 自动化任务重试代理请求前要检查什么。
常见问题
代理 IP 返回的 Retry-After 怎么读?
两种都合法,按响应头格式解析即可:纯数字是秒数,带日期的是绝对时间。解析失败不要猜,按暂停并人工判断处理。
重试间隔要不要固定?
不要。间隔逐步拉长并加随机抖动,否则大量任务会在同一秒重新涌上去。固定间隔在任务量上来时,等于自己制造一次小峰值。
POST 请求是不是一律不能重试?
不是。能不能重发取决于接口语义、幂等保障以及目标端状态是否可核实,不只看方法名。若状态暂时查不到且没有幂等键,应暂停自动重试并先做对账或人工复核。
并发高的时候次数要不要下调?
要。总量由并发乘次数决定,但上限先按目标站公布的访问限制和已批准的任务配额定,再分摊到单条请求;不能靠试探出口的承载能力来提高请求量。并发翻倍而次数不变,等于把压力也翻倍。
