先确认适用条件

适用于脚本里用 curl 下载公开文件或读取接口,偶发超时或服务端临时错误。本文示例只发起无副作用的 GET;创建订单、提交表单和上传操作要先确认服务端是否已经处理,不能套用下载的重试策略。

先区分原因与影响范围

--retry 只对特定临时错误重试,不会把所有失败都当成网络抖动。--retry-all-errors 会扩大范围,可能重复发送数据。超时只说明客户端没及时拿到结果,并不能证明服务器尚未执行请求。

按顺序检查,每次只改一项

  1. 先保存一次失败的 HTTP 状态、curl 退出码与时间。辨明原命令是 GET、POST 还是上传;写操作先查询实际结果或服务端幂等机制,再决定是否能重试。
  2. 对可重复读取的 GET,使用较小的 --retry 次数,同时设置 --connect-timeout、--max-time 和 --retry-max-time。不要让定时任务与命令自身同时无限重试。
  3. 保留默认退避行为。收到 429 时遵守服务器的等待要求;401、403 或持续 404 应处理认证、权限或地址,不用扩大到全部错误来掩盖原因。
  4. 把响应体写进新的临时文件,成功核对状态与文件内容后才替换正式配置。不要直接把多次尝试的输出追加进现有订阅文件,也不要让重复响应流进解析管道。
macOS / Linux shell 示例;无管理员权限;在新建空目录运行,替换为可安全重复读取的真实 URL
curl -q --retry 2 --retry-max-time 45 --connect-timeout 10 --max-time 20 --fail --output response.part "https://example.com/"
# 紧接上一条读取退出码,先不要执行其他命令
echo "$?"

怎样确认已经恢复

在实际输出中核对尝试次数和最后的退出码,并打开或校验下载文件。--retry-max-time 是允许继续重试的时间窗口,单次传输仍由 --max-time 限制,不应把前者当作严格的总耗时上限。

未恢复时如何回退与求助

删除新增的重试选项或改为 --retry 0 即可回到单次请求。保留失败临时文件用于检查;若是写操作且结果不确定,先向接口所有者查请求记录,避免重复提交。