timeout命令需配合-k强制杀招、--foreground防逃逸，并显式判断退出码124以区分超时与失败；在systemd或cron中须补全PATH及绝对路径，管道调用须整体包裹。
直接用 timeout 命令包裹调用即可，关键是选对信号、加强制杀招、显式判码——不是加个时间参数就完事。
核心操作：用 -k 强制兜底 + --foreground 防逃逸
不稳定二进制（比如某个老版本的 ffmpeg、pdf2text 或私有 CLI 工具）常会忽略 SIGTERM、fork 出子进程脱离控制，或卡在系统调用里不动。默认 timeout 30s ./unstable-bin 很可能失效。
- 加
--foreground：防止它因新建会话而脱离 timeout 的进程组，确保子进程也被纳入管控 - 必须加
-k 3s（或更短）：先发SIGTERM，3 秒后不管是否响应，立刻发SIGKILL强杀 - 完整写法示例：
timeout --foreground -k 3s 30s ./unstable-bin -i input.pdf -o output.txt
退出码必须显式判断，不能靠 && 或 if 直接分支
超时返回 124，命令失败可能返回 1、2、127 等，混在一起会导致误判。生产脚本里务必解构 $?：
timeout --foreground -k 2s 20s ./my-tool --runcase $? in0) echo "success";;124) echo "KILLED: timeout after 20s" >&2; exit 1;;127) echo "ERROR: binary not found or permission denied" >&2; exit 1;;*) echo "FAILED: exit code $?" >&2; exit 1;;esac
在 systemd service 或 cron 中要补环境短板
交互终端能跑通，放到后台服务里常静默失败——根本原因是 PATH 缺失、无 TTY、或缺少依赖库路径。
- systemd service 中：显式设置
Environment=PATH=/usr/local/bin:/usr/bin:/bin，并加StandardOutput=journal方便查日志 - cron 任务中：所有路径写绝对路径，例如
/usr/bin/timeout -k 5s 60s /opt/vendor/tool --flag - 若工具内部调用了 ssh、sudo、docker 等需 TTY 的命令，加
-t参数（如ssh -t）或用script -qec包一层
管道和复杂调用必须整体包裹
别只给第一个命令套 timeout，否则后续命令照常运行：
- ❌ 错误：
timeout 10s cat input.json | ./unstable-parser→ 只杀 cat，parser 继续跑 - ✅ 正确：
timeout --foreground -k 2s 10s sh -c 'cat input.json | ./unstable-parser > output.json' - 如果涉及重定向、变量展开或环境设置，统一放进
sh -c字符串里，避免 shell 解析阶段逃逸
