适用范围与准备

适用于一条curl命令顺序下载多个公开文件,前一个请求报错、最后一个成功,脚本却继续执行的情况。先在独立目录保存结果;本篇不涉及并行传输,也不把执行成功当作文件内容正确。

先区分原因

默认情况下,多URL传输会继续尝试后续目标,最后一次传输的结果可能掩盖前面的失败。--fail-early遇到传输错误就停止,但它本身不把HTTP 404变成传输错误;是否因HTTP错误失败由--fail或--fail-with-body控制。

按顺序操作

  1. 先列出每个URL对应的输出路径和预期内容,确认命令没有--parallel。记录原来的错误原文与最终退出状态,避免把多个文件合并写到一个输出中。
  2. 在单次命令中添加--fail-early;对于应当拒收HTTP错误页的下载同时添加--fail。只请求无写入副作用的目标,不用付款、上传或删除接口验证是否会中止。
  3. 若用了--next划分操作,给每个需要检查HTTP错误的操作分别加--fail。--fail-early是全局选项,--fail却不会跨越--next自动继承。
  4. 用受控的第一个失败、第二个成功的测试URL验证:失败后第二个传输应未开始,退出状态非零。不能为了制造失败而访问陌生接口或反复打生产站。
  5. 分别检查已生成的文件,保留失败日志。提前停止不会替你回滚之前完成的下载,也不能证明失败目标没有留下部分文件;确认内容及可信校验值后才能替换正式配置。
macOS / Linux shell;域名为占位,替换为有权访问的测试目标;无需管理员权限
curl -q --fail-early --fail --connect-timeout 10 --max-time 20 -o first.body -o second.body "https://example.com/first" "https://example.com/second"
观察项含义与下一步
--fail-early首个传输错误停止后续顺序传输
--fail把HTTP错误响应计为失败;跨--next需重新设置
已有文件仍需检查完整性,不能据文件存在判成功

怎样确认有效

验收要同时观察失败退出状态、后续目标是否收到请求,以及各输出文件是否完整。只看到脚本停止还不够;将测试顺序调成先成功后失败,也应正确保留失败结果。

无效时恢复与下一步

撤回本次命令参数即可恢复原来的继续下载行为。若任务要求所有目标都尝试,应逐项收集结果并汇总失败,而不是靠最后一个URL的退出码判断整个批次健康。