# Node.js 网站巡检脚本：检查 HTTP 状态、超时与失败退出码

原文：https://itjc.com/tutorials/node-website-check/
主题：自动化工作流；级别：实战；更新时间：2026-11-15。

> 下载零第三方依赖的脚本，先验证成功、404 和超时，再接入定时任务；说明它不能代替页面内容和交易流程测试。

## 这次做一个小而可验证的巡检
脚本依次向目标网址发 GET 请求，输出每个网址的状态、耗时和失败类型。全部最终响应为 2xx 才返回退出码 0；任一失败返回 1；参数错误返回 2。它适合可用性初查，不检查页面正文是否正确，也不模拟登录或支付。

准备 Node.js 22 或更新的兼容环境，不依赖额外 npm 包。只检查你负责或获准检查的网址，先手动执行，确认请求频率合适后再安排定时运行。macOS、Linux 等环境均可使用，租一台 Mac 不是前置条件。

## 第一步：下载并查看代码
下载 [网站巡检脚本 site-check.mjs](/downloads/site-check.mjs)。先在编辑器查看，再保存在独立练习目录。它不会保存凭据、发送通知或修改网站内容。默认每个目标超时 5000 毫秒，最多 10 个网址，按顺序执行。

```sh
node --version
node site-check.mjs https://itjc.com/ https://itjc.com/llms.txt
```

脚本打印 JSON 行，方便后续保存或解析。下面只是格式示例，毫秒数与状态以你的实际请求为准。

```json
{"url":"https://example.com/","ok":true,"status":200,"durationMs":123}
```

## 第二步：理解状态与退出码
默认跟随重定向，检查最终响应。因此一个 301 跳转到正常页面可以通过，但这不能验证跳转链符合你的 SEO 设计。404、500 等非 2xx 响应标为 HTTP；超时标为 TIMEOUT；连接或证书等请求失败标为 NETWORK。

失败类型用于分流检查，不能仅凭 NETWORK 就认定服务器宕机。脚本运行机器自身的网络、DNS、证书环境也可能有问题。若需要检测特定跳转或页面标识，应另写针对性的检查，不要把一个 200 当作全部业务正常。

## 第三步：保存日志并观察退出码
在 macOS 或 Linux 终端可以这样执行。目标日志使用新名称，避免覆盖已有记录。

```sh
node site-check.mjs https://itjc.com/ > check-first.jsonl
result=$?
cat check-first.jsonl
printf 'exit=%s
' "$result"
```

result 保存的是脚本退出状态。不要在其他命令之后才读 $?，那样读到的可能是 cat 的状态。Windows 使用对应终端的退出码查看方式。

## 第四步：主动验证失败路径
先在自己的测试站准备一个确定返回 404 的路径，观察 HTTP 错误与退出码 1。超时需要一个已知延迟的受控端点；不要依靠随便找一个网站“恰好很慢”。没有测试环境时，可运行项目附带的本地验证工具，由它创建成功、404、超时和拒绝连接场景。

本站已经用本地受控 HTTP 服务测试下载脚本：200 成功、404、超时、连接拒绝、非法 URL 和混合目标。该结果证明脚本的这些分支经过检查，不能证明读者网络或所有生产网址可达。测试源文件随脚本一起提供：[本地验证工具](/downloads/check-site-check.mjs)，两份放在同一目录。

```sh
node check-site-check.mjs
```

## 第五步：再考虑定时与通知
手动结果可靠后，定时系统只需要启动同一条命令并保留时间与退出状态。每轮避免重叠；连续失败可以先复查，再按明确阈值通知；恢复时通知一次；同样状态不要每分钟重复轰炸。

当前脚本只提供一次巡检，不内置调度、告警、重试或历史存储。你可以先写出规则：“每小时一次、最多一轮、连续两次失败通知、恢复通知一次”，再实现状态文件和通知渠道。不要把通知 API 密钥写进公开教程或日志。

## 验收与下一步
- 成功目标退出 0；错误响应和受控超时退出 1。
- 参数错误退出 2；日志有网址、耗时和失败类型。
- 保存一份实际执行记录，能区分站点失败与巡检机器失败。
- 定时前先确定负责人、频率、重叠处理和通知阈值。

继续阅读 [设计自动化工作流](/tutorials/workflow-design/) 与 [定时巡检的边界](/tutorials/scheduled-checks/)。若任务将在远端运行，再做 [断开连接实验](/tutorials/remote-mac-task-persistence/)。

## 官方资料与参考

- [Node.js fetch 与 AbortSignal](https://nodejs.org/api/globals.html#fetch)
- [Node.js 进程退出状态](https://nodejs.org/api/process.html#processexitcode)
