GNU timeout 的状态归属：同样被终止，为什么一次返回124另一次返回143
给命令套上timeout后，外层脚本需要决定是重试、报警还是继续。但一个非零退出码可能来自业务程序本身，也可能来自超时包装器。启用preserve-status后，同样触发时间限制，得到的数字又会变化。先辨明返回状态属于哪一层，才能避免把所有失败都归类成执行超时。
本例在Linux、Bash 5.2.37与GNU Coreutils 9.7实跑，LC_ALL固定为C。输入都是固定测试文本；不覆盖业务文件。在线手册用于核对语义，不把手册显示的版本当作本地安装版本。
AI模型生成的概念示意图：计时包装器与内部子进程分别连向124和143状态牌，零表示例子中的正常完成分支；不是实拍、软件界面或运行截图，精确数量及行为以代码和实际输出为准。
完整程序与实际输出
保存为demo.sh，执行bash demo.sh。以下是本次完整程序及真实标准输出。
#!/usr/bin/env bash
set -euo pipefail
export LC_ALL=C
report() {
local label=$1 status
shift
if "$@"; then
status=0
else
status=$?
fi
printf '%s: %s\n' "$label" "$status"
}
report child_exit_7 timeout 2s bash -c 'exit 7'
report ordinary_timeout timeout 0.1s sleep 2
report preserve_status timeout --preserve-status 0.1s sleep 2
report no_timeout timeout 2s true本次实际标准输出：
child_exit_7: 7 ordinary_timeout: 124 preserve_status: 143 no_timeout: 0
四个短命命令各自验证什么
第一条子命令直接exit 7，在两秒限制内退出，因此report记录七。第二条让sleep休眠两秒，但timeout只给十分之一秒，实际得到124。第三条保持相同等待，只增加preserve-status，得到143。最后用true验证未触发超时的成功路径，返回零。整个脚本只管理自己新建的演示子进程。
默认超时路径把结果标成124，便于调用者发现时间限制已经触发。preserve-status则保留被管理命令的结果，本次sleep被默认TERM信号终止，在所列环境中显示为128加15，即143。这个143不是所有超时场景的固定答案：更换信号、子程序处理信号的方式或退出策略，都可能得到不同结果。
示例没有精确测量墙钟耗时，也不声称进程恰好在一百毫秒结束。调度、系统负载和信号处理都会影响实际时间。这里使用明显长于限制的sleep，目标只是触发两个已知状态分支；真正的性能或期限验收，应另行记录单调时钟和整体耗时。
捕获失败时先保存真正的状态
report把命令放在if条件中执行，再在else的第一步保存问号变量。这样预期的非零状态不会因为脚本开启set -e而直接终止演示，也不会被随后的printf等命令覆盖。标签与数字一同输出，方便区分四次调用。命令参数通过带引号的参数数组形式转发，避免把整条命令再次拼成字符串解析。
生产脚本通常还应保留标准错误以及程序自己的结构化诊断。单个数字的信息容量有限，例如被执行程序本来也可能主动返回124，或自己返回143；只看到数字不能无条件推出相应信号一定发生。若业务需要精确区分，应为被管理程序的退出码划定约定，并结合外层诊断或额外记录。
工具自身失败、命令不存在或不能启动，也有与业务退出不同的状态。与其写一个“只要非零就重试”的分支，不如把可以重试的情况列为白名单，并让其他错误进入可观察的失败路径。拼错可执行文件名称，反复重试并不能让它变成暂时性超时。
时间限制不是自动回滚
一个命令被终止之前，可能已经写了一部分文件、提交了数据库事务或发送了远程请求。timeout只围绕进程生命周期施加限制，并不了解这些外部效果。看到124后立即把整条业务操作重复一次，可能造成重复提交或半成品覆盖。是否允许重试，应由幂等键、事务边界和结果查询机制决定。
被管理程序也可能捕获或忽略TERM，在清理完之前继续运行。若任务需要最终强制结束，可研究kill-after等选项，但强制信号会减少清理机会，必须事先考虑数据完整性。本文没有为了演示而杀死任何现有服务，也没有把强制终止当作默认修复手段。
当命令会启动额外子进程或脱离当前进程组时，进程树的生命周期还需要单独验证。尤其不能只看最外层命令返回就认定所有后代进程都结束。对于长期服务，使用能够管理整个服务生命周期的运行系统通常更合适；一个小型超时包装器不应承担它没有承诺的管理能力。
选择保留状态之前先问监控要看什么
如果监控最关心“是否触发过时间限制”，默认124语义较直接；如果上层已经有其他方式记录超时，而需要保留程序自身的退出行为，可以考虑preserve-status。两者没有普遍更好的一种，关键是日志、报警和重试策略必须使用同一份约定。
本例四个结果可以作为部署环境的冒烟测试，但还应对真实程序补充正常业务失败、主动处理TERM、部分写入和后代进程清理等测试。最终需要回答的不是某个数字是否熟悉，而是本次操作执行到了哪里、哪些结果可复用，以及再次执行是否安全。
资料与验证范围
官方资料核验于2026年10月3日。本次程序退出码为0，标准错误为空；例子覆盖固定输入的选项语义，不表示所有平台、版本和生产工作负载完全一致。
