先确认适用条件
适用于脚本里用 curl 下载公开文件或读取接口,偶发超时或服务端临时错误。本文示例只发起无副作用的 GET;创建订单、提交表单和上传操作要先确认服务端是否已经处理,不能套用下载的重试策略。
先区分原因与影响范围
--retry 只对特定临时错误重试,不会把所有失败都当成网络抖动。--retry-all-errors 会扩大范围,可能重复发送数据。超时只说明客户端没及时拿到结果,并不能证明服务器尚未执行请求。
按顺序检查,每次只改一项
- 先保存一次失败的 HTTP 状态、curl 退出码与时间。辨明原命令是 GET、POST 还是上传;写操作先查询实际结果或服务端幂等机制,再决定是否能重试。
- 对可重复读取的 GET,使用较小的 --retry 次数,同时设置 --connect-timeout、--max-time 和 --retry-max-time。不要让定时任务与命令自身同时无限重试。
- 保留默认退避行为。收到 429 时遵守服务器的等待要求;401、403 或持续 404 应处理认证、权限或地址,不用扩大到全部错误来掩盖原因。
- 把响应体写进新的临时文件,成功核对状态与文件内容后才替换正式配置。不要直接把多次尝试的输出追加进现有订阅文件,也不要让重复响应流进解析管道。
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 即可回到单次请求。保留失败临时文件用于检查;若是写操作且结果不确定,先向接口所有者查请求记录,避免重复提交。