timeout --kill-after二次信号发送机制详解：为什么TERM杀不掉的进程终于退出了

写Shell脚本给命令加超时限制，timeout默认超时发的是SIGTERM信号。可很多时候目标进程要么自己捕获了TERM优雅退出逻辑跑飞了，要么干脆忽略TERM，结果超时了进程还活着，脚本卡在那儿干等。timeout --kill-after就是专门解决这个"杀不死"问题的二次信号机制。这篇文章把它的工作逻辑、时间线和3个常见误区一次讲透。

一、先回顾timeout的退出流程

timeout来自GNU coreutils，基本用法是timeout 10s ./task.sh。它给目标命令设一个时限，时限一到就发信号。默认发SIGTERM（15号），进程没特意处理就会被终止。关于默认信号和退出码的细节，可以参考timeout退出码124和125区别详解。但问题在于：SIGTERM是"请求退出"，进程完全可以不理会。

二、--kill-after到底做了什么

--kill-after=DURATION（短写-k）的含义是：当timeout发出第一个信号后，如果目标进程在额外的DURATION时间内仍然存活，就补发一个SIGKILL（9号）信号。SIGKILL是操作系统级别的强制终止，进程无法捕获也无法忽略，必然退出。

时间线拆解

假设命令是timeout -k 5s 10s ./task.sh：

• 0s：task.sh启动；
• 10s：timeout发出SIGTERM；
• 10s~15s：等待5秒（即--kill-after的值）；
• 15s：若task.sh还活着，发出SIGKILL，强制结束。

所以进程最多存活"超时时长 + kill-after时长"。整个机制是一个兜底保险：先用温和的TERM礼送，礼送不走再用KILL强拖。

SIGTERM和SIGKILL的本质区别

• SIGTERM（15）：通知进程退出，进程可以捕获、清理资源后退出，也可以直接忽略；
• SIGKILL（9）：内核直接回收进程，不给任何善后机会，也绝不可能被忽略。

正因为TERM可能被忽略，--kill-after才有存在价值。

三、最常见的3个认知误区

误区1：kill-after是从命令启动时算

错。-k的计时起点是"发出第一个信号那一刻"，不是timeout启动那一刻。上面例子里KILL在15s发出，而不是5s。如果你把-k理解成"总共只给5秒"，结果会和你预期完全相反。

误区2：加了--kill-after进程就一定死

绝大多数情况是的，但有一种例外：进程卡在不可中断睡眠（D状态，比如某些磁盘I/O夯死）时，连SIGKILL也暂时无法生效，要等它从内核态返回。这种极端情况属于系统级故障，不是timeout能解决的。

误区3：被KILL后退出码会变化

不会。无论最后是TERM还是KILL终结了进程，只要是因为超时被杀，timeout统一返回退出码124。想拿到子进程真实退出码，可以配合--preserve-status，详见timeout --preserve-status保留原退出码用法。

四、实战用法示例

示例1：基础兜底写法

timeout -k 5s 30s ./slow_backup.sh

30秒超时先发TERM，5秒不退就发KILL。

示例2：自定义第一个信号

timeout -s INT -k 3s 20s ./server.sh

时限20秒，超时先发INT（Ctrl+C等效），3秒不退再KILL。

示例3：脚本里配合退出码判断

timeout -k 5s 60s ./etl_job.sh
if [ $? -eq 124 ]; then
  echo "任务超时已被强制终止"
fi

注意$?拿到的是timeout的退出码，不是子进程的。结合xargs批量跑任务时，这套逻辑尤其好用，参考timeout命令与xargs配合使用技巧。

五、什么时候该用--kill-after

• 跑不可信或历史遗留脚本，担心它忽略TERM卡死；
• 定时任务里执行可能夯住的程序，必须保证到点释放资源；
• 需要"温和退出+强制兜底"两道保险的关键业务。

对于普通一两秒就结束的命令，其实不需要--kill-after，默认TERM足够；但凡是涉及外部依赖、网络或磁盘的长时间任务，加上它就是多一层安心。

六、小结

timeout --kill-after的本质是"先礼后兵"：TERM礼送，KILL强收，计时从发第一个信号开始算，被强杀仍返回124。记住时间线和那3个误区，你的超时控制脚本就不会再因为"杀不死"而卡住了。