Jenkins执行返回非零状态码125无报错信息排查求助

问题场景 #

操作Jenkins部署时，系统返回状态码125但无详细错误信息，部署服务器与主服务器的SSH转发测试已通过，相关日志如下：

SSH: 从主机[ip-122.222.222]连接中
SSH: 使用配置[test2]进行连接...
SSH: EXEC: 执行完成，耗时7,807毫秒
SSH: 断开配置[test2]的连接...
ERROR: 发布时发生异常，异常信息[Exec退出状态非零。状态码[125]]
Finished: UNSTABLE

可能原因及排查步骤 #

• 命令权限不足：检查Jenkins使用的SSH用户在目标服务器上执行部署命令的权限，比如是否需要sudo但未配置免密，或目标文件/目录的读写执行权限不满足。
• 命令语法/路径错误：确认部署命令中的文件路径、脚本名称是否正确，相对路径可能因Jenkins工作目录与预期不符导致找不到资源。
• SSH插件命令转义问题：若使用Jenkins SSH插件执行命令，检查是否存在特殊字符（如|、>、&）未正确转义，或命令换行格式错误。
• 目标服务器资源瓶颈：排查目标服务器是否存在磁盘满、内存不足、进程数超限等情况，这类资源问题可能导致命令异常退出。
• 插件版本兼容问题：尝试更新Jenkins SSH插件至最新稳定版，旧版本可能存在执行状态码返回异常的已知问题。

验证手段 #

• 手动使用Jenkins连接的SSH账号，在目标服务器上执行完全相同的部署命令，查看是否有具体错误输出。
• 在Jenkins执行的命令开头添加set -x，强制输出命令执行的每一步细节，定位出错环节。

内容的提问来源于stack exchange，提问作者kyubeom