适用范围与准备
适用于用 curl 小样本检查代理路径或订阅下载,脚本已经启用 --retry,最后看到HTTP 200却遗漏了此前失败的情况。本文只处理获准的无副作用GET,并把首次成功与重试后恢复分开;不据此计算服务全年可用率。
先区分原因
--retry 设置允许重试的次数,不代表实际发生了同样多次重试。符合条件的临时错误可能先失败再恢复,最终成功可以证明本轮交付完成,却不能证明首次请求成功。只保存最后一个状态码,会让恢复机制掩盖之前的错误。
按顺序操作
- 保存原命令,确认是否由curl、外层脚本或客户端分别重试。先运行 curl --version;num_retries 输出变量从8.9.0起提供,旧版本报不认识时不能把空值当成零。
- 选定无需登录和付费的小目标,固定节点与请求方法。明确你要记录的是首次尝试结果还是允许恢复后的结果,两类样本分列,不能混在一个成功率里。
- 在支持该变量的版本中,同时记录最终HTTP状态和num_retries。已有 --retry 预算保持较小,并保留单次超时与重试时间窗口;不要为了看到成功就改成无限重试或扩大到所有错误。
- 若使用旧版本,保留curl的错误/重试提示及自己控制的服务端请求记录,明确实际次数是否能确认。只知道命令配置了 --retry 1,不能证明它真的重试了一次;也不要为取样把真实认证头写进公开调试日志。
- 对出现重试的样本保存初次错误类别、最终内容结果和测试条件。必要时在受控目标上用 --retry 0 做单次对照,但只对可安全重复读取的GET进行,不把这个方法用于订单、上传或其他写操作。
curl -q --proxy http://127.0.0.1:7890 \
--retry 1 --retry-max-time 20 \
--connect-timeout 5 --max-time 10 --fail -sS \
--output /dev/null \
--write-out "http=%{http_code} retries=%{num_retries}\n" https://example.com/| 结果 | 能得出的结论 |
|---|---|
| 最终200且实际重试数为0 | 本次未使用curl自动重试;仍须核对内容 |
| 最终200且实际重试数大于0 | 曾触发重试,后来恢复 |
| 变量不支持或记录丢失 | 次数未验证,不能填0 |
| 配置--retry 1 | 重试预算,不是已执行次数 |
怎样确认有效
有效记录必须保留是否重试和最终交付结果,失败样本也不能删除。curl的计数不包含外层任务重新启动命令或代理内部重连,不能当作整条网络路径的全部尝试数;有限次数也不能支持“永不掉线”的结论。
无效时恢复与下一步
结束对照后恢复原脚本与重试预算,不留额外定时任务。仍频繁恢复时按初次错误阶段排查,而不是提高重试次数掩盖现象。本文未测试真实线路;本地HTTP夹具只验证先失败后恢复的现象,num_retries仍须在支持的安装版本核对。