ChatGPTClaudeGrok / X / CursorGemini

DeepSeek Harness 子进程退出码怎么看:0、1、127、137 与信号各代表什么

故障排查发布于 2026-11-18作者: DeepSeek Plugin 插件市场
DeepSeek HarnessDSH plugin退出码子进程信号
127 是命令找不到还是解释器缺失,137 是内存不足还是被强杀?本文给 0、1、2、126、127、137、143 的常见来源、退出码与信号的 128+N 换算,以及看到退出码后下一步查什么。

看到退出码,先别把它当成错误信息本身。 退出码只说明「进程怎么结束的」,不说明「为什么」。127 可能是命令没装,也可能是 PATH 不对;137 可能是内存不足,也可能是有人强杀(来源)。会读退出码,是为了把排查范围缩小,而不是直接得到结论。

DeepSeek Harness 退出码从哪来

退出码由子进程返回,DeepSeek Harness 只是把它带出来。 命令自己 exit N、shell 因找不到命令返回 127、操作系统因信号终止进程,都会形成一个退出码。(来源)

三个来源要分清:

  1. 程序主动退出 — 程序自己决定返回什么,例如测试失败返回 1;
  2. shell 代返 — 命令不存在、不可执行、解释器缺失,由 shell 返回固定值;
  3. 信号终止 — 进程被信号杀死,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 不会改变退出码的含义,但会增加一层工具结果。 子进程退出码会被带进工具结果,同时工具可能附加错误码、输出摘要与状态。(来源)

三个差异要注意:

  1. 工具失败不等于进程失败 — 输出不符合 schema、spill 写入失败、结果过大,都可能让工具判失败,即使退出码是 0;
  2. 进程失败不等于工具一定失败 — 有些工具把非零退出码当作正常业务结果返回,由调用方判断;
  3. 错误码与退出码分层 — 工具错误码描述工具层,退出码描述进程层;排查时先看哪一层先失败。

这也是为什么「命令手动跑成功,在工具里失败」很常见:命令本身没问题,是工具的输出约束或权限约束没满足。

glob/grep 这类工具通过 ctx.subprocess 调随包二进制,不经过 shell;它们没有 shell 的 127 代返,错误会以工具错误呈现。不要把 shell 退出码经验直接套到所有工具上。

DeepSeek Harness 三个排查例

三个例子对应三类退出码,按顺序排查即可。 每个例子只给最小动作(来源):

  1. 127 命令找不到 — 先在同样环境手动执行 command -v <cmd>;找不到再查安装与 PATH,找得到再查解释器与 shebang。
  2. 137 被强杀 — 先看系统 OOM 日志与内存曲线;没有 OOM 再看是否有其他进程或脚本执行了 kill。
  3. 143 被终止 — 先看是否有人取消任务或服务停止;再看超时清理是否发送 SIGTERM;最后查程序是否处理了该信号。

三个例子的共同点是「先确认退出码来源,再查原因」。不要看到非零就直接改代码;很多非零是环境或取消造成的。

如果退出码是 0 但结果不对,不要继续查退出码。转去查输出、路径、权限与工具 schema;这是另一层问题。

DeepSeek Harness 验证:构造退出码

验证排查方法,最好的方式是主动构造退出码。 四个小实验(来源):

  1. sh -c 'exit 0' — 确认成功路径与输出;
  2. sh -c 'exit 2' — 确认用法错误如何呈现;
  3. 执行一个不存在的命令 — 确认 127 在工具里如何显示;
  4. 启动长命令后取消 — 确认 130/143 或平台对应值,以及清理行为。

四个实验跑完,你就知道工具层如何包装退出码、取消会产生什么值、清理是否执行。比在真实故障里猜快得多。

旧文 fix-subprocess-byte-truncation-utf8 讲字节截断,fix-subprocess-scope-unit-leak 讲 scope 泄漏,develop-subprocess-spawn-spec 讲 spawn 契约;本篇补的是退出码与信号对照。先读退出码,再读错误码。

ChatGPTClaudeGrok / X / CursorGemini

常见问题

DeepSeek Harness 里命令退出码 127 是什么意思?

DeepSeek Harness 里,127 通常表示命令找不到,或解释器路径不存在。DeepSeek Harness 的子进程返回 127 时,先查命令是否安装、PATH 是否包含它、脚本解释器是否存在。

DeepSeek Harness 里退出码 137 是不是内存不足?

DeepSeek Harness 里,137 表示进程被 SIGKILL 终止,常见原因是内存不足被系统杀掉,也可能是被手动强杀。DeepSeek Harness 里看到 137,要结合系统日志与任务时长判断,不能只归因内存。

DeepSeek Harness 里退出码 130 和 143 分别代表什么信号?

DeepSeek Harness 里,按 128+N 换算,130 对应 SIGINT(通常是 Ctrl+C),143 对应 SIGTERM(通常是正常终止请求)。DeepSeek Harness 的取消路径可能产生这两类退出码。

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 目录

来源