侧边栏壁纸
博主头像
一笑痕

人生若只如初见,
是可喜亦或者是可悲?

  • 累计撰写 283 篇文章
  • 累计收到 7 条评论

timeout 的 SIGTERM 后,exit 先于 close

2026-11-16 / 0 评论 / 5 阅读

timeout 的 SIGTERM 后,exit 先于 close

子进程跑到超时后,代码里常要同时做状态记录和资源清理。若把 exit 与 close 当成同一个收尾点,日志可能重复记账,也可能在输出流尚未收完时就把任务标成彻底结束。Node 的 ChildProcess 把这两个时刻分开了。

本机实验使用 Node v26.8.1,在 spawn() 选项里设置 timeout: 200 和 killSignal: 'SIGTERM'。子进程向 stdout 写一行,然后用定时器保持运行。父进程等超时,由 Node 发送信号;没有手动调用 child.kill()。实验只在本机启动这个子进程,没有连接外部服务。

超时触发的是信号,不是同步取消

timeout 到期后,Node 会尝试用 killSignal 结束子进程。这里的 kill 是操作系统发送信号的接口,不意味着进程已经在调用发生的那一刻消失。child.kill() 返回值也只说明信号是否成功发送,不能拿它当作退出确认。进程可能捕获信号并继续执行,因此真正的结束状态要等事件回报。

本次实验显式设置 SIGTERM,避免依赖默认值。子进程没有注册信号处理器,所以系统按默认行为终止它。结果里 code 是 null,signal 是 SIGTERM。被信号结束时不能期待拿到常规退出码;判断任务为何结束,要看 signal 字段。

runtime: v26.8.1 (darwin)
options: timeout=200ms killSignal=SIGTERM
stdout: "child started"
stderr: ""
events: [{"event":"exit","code":null,"signal":"SIGTERM"},{"event":"close","code":null,"signal":"SIGTERM"}]
assertion: PASS (exit precedes close; code=null; signal=SIGTERM)

close 还要等 stdio 收尾

实测事件数组先记录 exit,再记录 close。两次回调的参数都是 code=null 和 signal='SIGTERM'。exit 表示进程已经结束;close 则表示子进程关联的 stdio 流都已关闭。若 stdout 或 stderr 里还有已进入管道的数据,读取端仍需处理完,close 才是更适合做最终收尾的节点。

这两个事件的回调顺序有明确含义,不应靠计时器猜。只关心进程是否结束时可以监听 exit;还要确保输出收集完成、统一关闭文件或释放依赖时,选 close 更稳。若两个回调都更新同一条任务记录,尤其要避免各自把完成数加一。

stdout 和 stderr 是两条独立的可读流。子进程结束后,数据仍可能在父进程的管道里等待读取;若只在 exit 时处理已经累计的字符串,尾部内容不该假定已经全部到齐。常见写法是在 data 回调里收集数据,在 close 回调里把最终结果交给后续逻辑。若需要边读边写文件,还应处理 Writable 的背压和错误,close 只说明流生命周期结束,并不替代数据写入是否成功的检查。

exit 与 close 的差别也影响异常路径。启动命令失败时,可能出现 error 而没有正常的进程退出;不要把监听 exit 当作唯一的完成回调。实际程序可以让 error 记录启动或信号发送问题,把最终资源清理放进统一的结束逻辑,并防止多个事件重复释放。实验只覆盖了进程成功启动、超时后被 SIGTERM 结束这一条路径,启动失败没有在这次脚本里模拟。

这里的 timeout 不是保证在 200 毫秒准时完成清理的期限。它触发发送信号,实际退出时刻还受系统调度影响;若子进程处理 SIGTERM 后不退出,进程也可能继续活着。生产代码需要额外的强制终止策略,并对后续状态做观察,本次实验没有验证信号处理器和强制终止之间的竞态。

我会把 close 用作输出流收齐后的最终完成点,而不是在 exit 里提前读完结果。超时后记录 signal,正常退出才看 code;两个字段分别表达结束方式。

    🤞 分享