命令行与文本处理 / 系统课时

用 curl 检查 HTTP 服务是否正常

用 curl 检查 HTTP 服务是否正常

服务进程还在,并不代表 HTTP 接口真的能处理请求。更可靠的巡检方式是让 curl 发起一次真实请求,同时观察网络请求是否成功以及 HTTP 状态码是否处于可接受范围,从而给监控脚本提供明确的退出状态。

学习目标

  • 使用 curl 获取 HTTP 状态码并限制连接、请求超时时间
  • 区分网络请求失败与服务器返回 4xx、5xx 两类异常
  • 用 Shell 退出码把巡检结果交给定时任务或上层恢复脚本

先区分两层故障

HTTP 巡检至少要判断两件事:请求能不能完成,以及完成后服务返回了什么状态码。DNS 解析失败、连接被拒绝、连接超时等问题会让 curl 本身返回非零退出码;而服务器正常返回 404 或 500 时,默认情况下 curl 仍可能以 0 退出。

因此只写 curl URL 并检查 $? 不够。巡检脚本应先判断 curl 是否成功执行,再读取 %{http_code} 判断业务侧 HTTP 结果。

编写最小巡检脚本

下面的脚本接受一个健康检查 URL,只下载状态码而不保存响应正文,并为连接和整个请求设置超时。这里把所有 2xx 状态视为健康;如果你的接口只允许 200,可以进一步收紧条件。

bash
#!/usr/bin/env bash
set -u

url="${1:?usage: $0 <health-url>}"

if ! status="$(curl -sS -o /dev/null -w '%{http_code}' \
  --connect-timeout 3 \
  --max-time 5 \
  "$url")"; then
  echo "unhealthy reason=request_failed"
  exit 2
fi

if [[ "$status" =~ ^2[0-9][0-9]$ ]]; then
  echo "healthy http_status=$status"
  exit 0
fi

echo "unhealthy http_status=$status"
exit 1

预期输出

当目标地址正常返回 HTTP 200 时:

text
healthy http_status=200

如果服务器能够响应但返回 HTTP 503,则输出:

text
unhealthy http_status=503

连接超时、域名解析失败或目标端口拒绝连接时,curl 会先输出自身错误信息,脚本随后输出:

text
unhealthy reason=request_failed

三个退出状态承担不同含义:0 表示 HTTP 服务健康,1 表示收到了 HTTP 响应但状态不健康,2 表示请求本身没有成功完成。实际网络错误文本会随故障原因和 curl 版本不同而变化。

为什么要同时设置两个超时

--connect-timeout 3 限制建立连接阶段最长等待 3 秒,--max-time 5 则限制整次请求的总耗时。如果只设置连接超时,服务成功建立 TCP 连接后仍可能长时间不返回响应;如果完全不设置超时,定时巡检进程可能被一个异常请求长期占住。

超时值应略高于接口正常延迟,而不是越短越好。例如正常请求偶尔需要 2 秒时,把总超时设置为 1 秒会制造大量误报。巡检频率、正常延迟和允许的恢复时间需要一起确定。

不要把所有 HTTP 状态都当成 curl 失败

curl 默认把 HTTP 传输成功和 HTTP 业务状态分开处理。收到 500 说明网络、TCP 和 HTTP 协议层都已经完成交互,只是服务器报告内部错误,所以脚本应保留状态码,而不是把它和“无法连接”混成同一种故障。

对于需要鉴权的接口,还要确认健康检查端点是否允许巡检脚本访问。若接口固定返回 401,脚本虽然能证明服务器存在,却不能证明业务健康。生产环境通常会提供一个轻量的 /health、/ready 或同类端点,并明确约定哪些状态码代表可用。

把退出码交给自动化流程

定时任务、CI、监控代理或后续的自动恢复脚本都可以直接根据退出码决定是否继续处理。这样 HTTP 检测只负责提供事实,不在同一个脚本里立即执行重启、告警等所有动作,后续调整故障阈值或恢复策略时更容易控制风险。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 curl 检查 HTTP 服务是否正常

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

登录哪都通