Linux 与服务器运维 / 系统课时

使用 curl 测试 HTTP 服务

使用 curl 测试 HTTP 服务

测试 HTTP 服务时,单看页面内容往往不够,还要同时确认状态码、响应头和响应体。本文用一个可本地复现的 curl 示例完成这三项检查,并说明重定向、超时和 HTTP 错误应如何区分。

学习目标

  • 能用 curl 获取 HTTP 状态码、响应头和正文
  • 能理解 -D、-o、-w、-sS 等常用参数的作用
  • 能区分 HTTP 错误与 DNS、连接、超时等传输层失败

用本地服务完成一次完整检查

下面先创建一个固定响应文件,再启动 Python 自带的静态 HTTP 服务。随后 curl 把响应头和正文分别保存到文件,并用 -w 单独打印状态码,最后清理测试进程。

bash
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"

预期输出

text
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 能覆盖这条链路的大部分环节,但每一步代表不同层次的问题,不能把所有失败都归因于服务端业务代码。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

使用 curl 测试 HTTP 服务

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通