DeepSeek Harness 子进程退出码怎么看:0、1、127、137 与信号各代表什么
看到退出码,先别把它当成错误信息本身。 退出码只说明「进程怎么结束的」,不说明「为什么」。127 可能是命令没装,也可能是 PATH 不对;137 可能是内存不足,也可能是有人强杀(来源)。会读退出码,是为了把排查范围缩小,而不是直接得到结论。
DeepSeek Harness 退出码从哪来
退出码由子进程返回,DeepSeek Harness 只是把它带出来。 命令自己 exit N、shell 因找不到命令返回 127、操作系统因信号终止进程,都会形成一个退出码。(来源)
三个来源要分清:
- 程序主动退出 — 程序自己决定返回什么,例如测试失败返回 1;
- shell 代返 — 命令不存在、不可执行、解释器缺失,由 shell 返回固定值;
- 信号终止 — 进程被信号杀死,shell 用 128+N 表示。
三者的排查方向不同:主动退出看程序逻辑,shell 代返看命令与环境,信号终止看资源与取消。
DeepSeek Harness 的工具层还会在子进程之外再包一层错误。命令退出码非零,工具可能判失败;命令退出码为 0,但输出不符合 schema,工具也可能判失败。两层不要混。
DeepSeek Harness 七个常见值
七个值覆盖大多数日常场景,先背表再谈细节。 对照如下(来源):
| 退出码 | 常见含义 | 先查什么 |
|---|---|---|
| 0 | 成功 | 输出与副作用是否符合预期 |
| 1 | 一般错误 | 程序日志、参数、业务失败 |
| 2 | 用法错误 | 参数格式、必填项、子命令 |
| 126 | 不可执行 | 文件权限、解释器、挂载 noexec |
| 127 | 命令找不到 | PATH、安装位置、拼写 |
| 137 | 被 SIGKILL 终止 | 内存、OOM、手动强杀 |
| 143 | 被 SIGTERM 终止 | 取消、服务停止、超时清理 |
0 不代表「结果一定对」。命令成功但输出为空、写错目录、返回了错误数据,退出码仍然是 0;这类问题要靠输出与副作用检查。
1 和 2 经常被混。1 是「程序跑了但失败」,2 是「程序没按预期启动」;前者看业务逻辑,后者看参数。
126 和 127 也经常被混。126 是「找到了但执行不了」,127 是「根本没找到」;前者看权限与格式,后者看 PATH 与安装。
DeepSeek Harness 退出码与信号的换算
128+N 是 shell 的常见编码,N 是信号编号。 记住几个常用的(来源):
- 130 = 128 + 2 — SIGINT,通常是 Ctrl+C;
- 137 = 128 + 9 — SIGKILL,无法被捕获,常见于强杀或 OOM;
- 143 = 128 + 15 — SIGTERM,通常是正常终止请求。
这个换算在 Linux/macOS 的 shell 里很常见,但不是所有平台都一样。Windows 的进程退出码与信号模型不同,不能直接套 128+N;在 Windows 上看到大整数退出码,先查程序或系统错误码。
信号还能解释「为什么清理没执行」。SIGKILL 不能被捕获,进程没有机会跑清理逻辑;SIGTERM 可以被捕获,但程序不一定处理。看到 137 时,不要期待临时文件被清理。
DeepSeek Harness 的取消路径通常会产生信号类退出码,具体取决于后端与命令。排查「取消后还有残留」时,先确认是哪种信号,再查清理逻辑。
DeepSeek Harness dsh 包装后的差异
DeepSeek Harness 不会改变退出码的含义,但会增加一层工具结果。 子进程退出码会被带进工具结果,同时工具可能附加错误码、输出摘要与状态。(来源)
三个差异要注意:
- 工具失败不等于进程失败 — 输出不符合 schema、spill 写入失败、结果过大,都可能让工具判失败,即使退出码是 0;
- 进程失败不等于工具一定失败 — 有些工具把非零退出码当作正常业务结果返回,由调用方判断;
- 错误码与退出码分层 — 工具错误码描述工具层,退出码描述进程层;排查时先看哪一层先失败。
这也是为什么「命令手动跑成功,在工具里失败」很常见:命令本身没问题,是工具的输出约束或权限约束没满足。
glob/grep 这类工具通过 ctx.subprocess 调随包二进制,不经过 shell;它们没有 shell 的 127 代返,错误会以工具错误呈现。不要把 shell 退出码经验直接套到所有工具上。
DeepSeek Harness 三个排查例
三个例子对应三类退出码,按顺序排查即可。 每个例子只给最小动作(来源):
- 127 命令找不到 — 先在同样环境手动执行
command -v <cmd>;找不到再查安装与 PATH,找得到再查解释器与 shebang。 - 137 被强杀 — 先看系统 OOM 日志与内存曲线;没有 OOM 再看是否有其他进程或脚本执行了 kill。
- 143 被终止 — 先看是否有人取消任务或服务停止;再看超时清理是否发送 SIGTERM;最后查程序是否处理了该信号。
三个例子的共同点是「先确认退出码来源,再查原因」。不要看到非零就直接改代码;很多非零是环境或取消造成的。
如果退出码是 0 但结果不对,不要继续查退出码。转去查输出、路径、权限与工具 schema;这是另一层问题。
DeepSeek Harness 验证:构造退出码
验证排查方法,最好的方式是主动构造退出码。 四个小实验(来源):
sh -c 'exit 0'— 确认成功路径与输出;sh -c 'exit 2'— 确认用法错误如何呈现;- 执行一个不存在的命令 — 确认 127 在工具里如何显示;
- 启动长命令后取消 — 确认 130/143 或平台对应值,以及清理行为。
四个实验跑完,你就知道工具层如何包装退出码、取消会产生什么值、清理是否执行。比在真实故障里猜快得多。
旧文 fix-subprocess-byte-truncation-utf8 讲字节截断,fix-subprocess-scope-unit-leak 讲 scope 泄漏,develop-subprocess-spawn-spec 讲 spawn 契约;本篇补的是退出码与信号对照。先读退出码,再读错误码。
常见问题
DeepSeek Harness 里,127 通常表示命令找不到,或解释器路径不存在。DeepSeek Harness 的子进程返回 127 时,先查命令是否安装、PATH 是否包含它、脚本解释器是否存在。
DeepSeek Harness 里,137 表示进程被 SIGKILL 终止,常见原因是内存不足被系统杀掉,也可能是被手动强杀。DeepSeek Harness 里看到 137,要结合系统日志与任务时长判断,不能只归因内存。
DeepSeek Harness 里,按 128+N 换算,130 对应 SIGINT(通常是 Ctrl+C),143 对应 SIGTERM(通常是正常终止请求)。DeepSeek Harness 的取消路径可能产生这两类退出码。
DeepSeek Harness 里不是这样。DeepSeek Harness 的工具错误码描述工具层失败,退出码描述子进程结束状态;命令成功退出但输出不合 schema,仍可能被工具判为失败。
相关术语
- 退出码
- 退出码是子进程结束时返回给父进程的整数,0 通常表示成功,非零表示不同类别的失败。— DeepSeek Harness 官方文档 - 子进程
- 信号
- 信号是操作系统向进程发送的异步通知,例如 SIGINT、SIGTERM、SIGKILL;进程被信号终止时,shell 常用 128+N 表示。— DeepSeek Harness 官方文档 - 子进程
- 128+N
- 128+N 是 shell 对被信号 N 终止的进程的常见编码方式,例如 128+9=137 表示 SIGKILL。— DeepSeek Harness 官方文档 - 子进程
- 工具错误码
- 工具错误码是 DeepSeek Harness 工具层返回的错误标识,与子进程退出码属于不同层,不能互相替代。— DeepSeek Harness 官方文档 - 工具 Schema 目录
来源
- DeepSeek Harness 官方文档 - 子进程· deepseek-harness
- DeepSeek Harness 官方文档 - 工具 Schema 目录· deepseek-harness