Shutdown Check

搜索文档

查找页面或章节

shutdown-check v1.0.1

在用户遇到 502 之前,先测试 Node.js 优雅关闭。

shutdown-check 会启动你真实的服务,发出几个慢请求,趁它们还在处理时发送 SIGTERM,然后验证:这些请求全部完成,就绪状态已撤回,新请求被拒绝,进程在截止时间前退出。你的代码一行都不用改。

npm install -D shutdown-check

支持任意 Node.js HTTP 服务零依赖Node.js 22+,支持 macOS 和 LinuxMIT 许可证

一次优雅关闭测试:从 SIGTERM 到退出码

跟着同一个服务走完整个检查:终端里的运行、配置文件、时间线上的排空过程、失败时给出的信息,以及 CI 中的把关。

一条命令,真实的 SIGTERM

用你实际的启动命令启动服务,等就绪检查通过、真实请求进入处理后,再发送信号。每一步都有计时。

无需改代码

一个 JSON 文件写明启动命令、就绪检查路由和一个慢路由。不需要在应用里引入任何东西。

看得见的排空过程

请求完成,就绪检查变为 503,新请求被拒绝,进程远在截止时间之前退出。

失败时告诉你原因

每个出错阶段都有固定的诊断码,并附上截至出错时的时间线、服务自身的输出和修复方法。

为每次部署把关

CI 任务可以按退出码判定失败,脚本可以读取 JSON,CI 也能直接展示 JUnit 报告。