适用条件与现象

适用于自动下载、代理连通检查或健康检查。目标返回一个 HTTP 页面说明收到了响应,但页面是否代表业务成功需要独立判断。

先区分原因

curl 默认主要报告传输层是否完成,HTTP 404 或 500 不一定使命令退出失败。--fail-with-body 可在 HTTP 状态为 400 及以上时返回错误并保留响应体,常见退出码为 22;该选项需要 curl 7.76.0 或更新版本。

按顺序操作

  1. 先检查 curl 版本,确认选项存在;旧版本应显式解析 HTTP 状态,不将未知选项退出误判为网站故障。
  2. 选择无副作用的小请求,同时输出 response_code 并立即保存命令退出码,避免后续命令覆盖它。
  3. 在受控测试服务分别验证正常响应与一个明确的错误响应,确认检查器能把后者报告为失败。
  4. 仍需判断内容或应用错误码:某些业务失败返回 HTTP 200,仅检测状态也会误报成功。
POSIX shell:同时显示状态与退出码
curl -q --fail-with-body --max-time 20 --output /dev/null --write-out "HTTP=%{response_code}\n" https://example.com/
curl_status=$?
printf "curl_exit=%s\n" "$curl_status"

怎样确认结果

传输错误、HTTP 错误和业务错误分别能被识别。示例为保持终端整洁主动丢弃正文;需要分析正文时保存到权限合适的临时文件,别让登录页冒充下载结果。

失败后的恢复与下一步

若旧脚本依赖退出码零继续执行,应先在测试环境确认错误分支,再替换判断。遇到状态 000 时先查连接与协议错误,它并不是服务端真实返回的 HTTP 状态。