Linux 与服务器运维 / 系统课时
使用 curl 测试 HTTP 服务
使用 curl 测试 HTTP 服务
测试 HTTP 服务时,单看页面内容往往不够,还要同时确认状态码、响应头和响应体。本文用一个可本地复现的 curl 示例完成这三项检查,并说明重定向、超时和 HTTP 错误应如何区分。
学习目标
- 能用
curl获取 HTTP 状态码、响应头和正文 - 能理解
-D、-o、-w、-sS等常用参数的作用 - 能区分 HTTP 错误与 DNS、连接、超时等传输层失败
用本地服务完成一次完整检查
下面先创建一个固定响应文件,再启动 Python 自带的静态 HTTP 服务。随后 curl 把响应头和正文分别保存到文件,并用 -w 单独打印状态码,最后清理测试进程。
mkdir -p /tmp/curl-demo
printf 'hello from curl\n' > /tmp/curl-demo/index.html
python3 -m http.server 18080 --directory /tmp/curl-demo >/tmp/curl-demo/server.log 2>&1 &
SERVER_PID=$!
sleep 1
curl -sS \
-D /tmp/curl-demo/headers.txt \
-o /tmp/curl-demo/body.txt \
-w 'status=%{http_code}\n' \
http://127.0.0.1:18080/
printf '%s\n' '--- headers ---'
cat /tmp/curl-demo/headers.txt
printf '%s\n' '--- body ---'
cat /tmp/curl-demo/body.txt
kill "$SERVER_PID"预期输出
status=200
--- headers ---
HTTP/1.0 200 OK
Server: SimpleHTTP/<VALUE> Python/<VALUE>
Date: <TIME>
Content-type: text/html
Content-Length: 16
Last-Modified: <TIME>
--- body ---
hello from curl<TIME> 和 <VALUE> 会随运行环境变化。这里的关键结果是状态码为 200、响应头已成功返回,正文内容与创建的文件一致。
读懂几个关键参数
-D <PATH> 把响应头写入指定文件,-o <PATH> 把响应体写入文件,-w 在请求结束后输出指定指标,-sS 隐藏进度条但保留错误信息。排障时这种组合比只运行 curl URL 更容易保留证据。
-i 会把响应头和正文一起输出,适合快速查看;-I 则发送 HEAD 请求,它与正常 GET 并不完全等价。若要验证真实 GET 的响应头,不应仅靠 -I 下结论。
状态码和命令失败不是一回事
HTTP 404、500 说明已经连到了 HTTP 服务,只是服务返回了错误状态;DNS 解析失败、TCP 连接被拒绝、TLS 握手失败或超时,则可能连 HTTP 响应都拿不到。常见的 curl 退出码包括 6(无法解析主机)、7(连接失败)和 28(超时)。
如果希望 4xx、5xx 也让命令返回非零退出码,同时保留响应体,较新的 curl 可使用 --fail-with-body。需要跟随 3xx 重定向时使用 -L,但应注意最终状态码可能来自重定向后的目标地址。
按顺序定位 HTTP 访问问题
遇到“接口访问失败”时,先确认域名是否能解析,再确认目标地址和端口是否可连接,然后检查 TLS,最后才分析 HTTP 状态码、响应头和正文。curl 能覆盖这条链路的大部分环节,但每一步代表不同层次的问题,不能把所有失败都归因于服务端业务代码。