适用范围与准备

适用于用 curl 小样本检查代理路径或订阅下载,脚本已经启用 --retry,最后看到HTTP 200却遗漏了此前失败的情况。本文只处理获准的无副作用GET,并把首次成功与重试后恢复分开;不据此计算服务全年可用率。

先区分原因

--retry 设置允许重试的次数,不代表实际发生了同样多次重试。符合条件的临时错误可能先失败再恢复,最终成功可以证明本轮交付完成,却不能证明首次请求成功。只保存最后一个状态码,会让恢复机制掩盖之前的错误。

按顺序操作

  1. 保存原命令,确认是否由curl、外层脚本或客户端分别重试。先运行 curl --version;num_retries 输出变量从8.9.0起提供,旧版本报不认识时不能把空值当成零。
  2. 选定无需登录和付费的小目标,固定节点与请求方法。明确你要记录的是首次尝试结果还是允许恢复后的结果,两类样本分列,不能混在一个成功率里。
  3. 在支持该变量的版本中,同时记录最终HTTP状态和num_retries。已有 --retry 预算保持较小,并保留单次超时与重试时间窗口;不要为了看到成功就改成无限重试或扩大到所有错误。
  4. 若使用旧版本,保留curl的错误/重试提示及自己控制的服务端请求记录,明确实际次数是否能确认。只知道命令配置了 --retry 1,不能证明它真的重试了一次;也不要为取样把真实认证头写进公开调试日志。
  5. 对出现重试的样本保存初次错误类别、最终内容结果和测试条件。必要时在受控目标上用 --retry 0 做单次对照,但只对可安全重复读取的GET进行,不把这个方法用于订单、上传或其他写操作。
macOS/Linux;仅适用于curl 8.9.0及以上,7890须替换,先另行确认目标内容;这里只读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仍须在支持的安装版本核对。