Build step 'Send files or execute commands over SSH' changed build result to UNSTABLE

Jenkins在通过SSH传输文件或执行命令时出现状态码127的错误，通常表示远程服务器上找不到指定的可执行文件或脚本。具体来说，状态码127是Linux系统中bash shell返回的一个标准错误代码，其含义是“command not found”（命令未找到）[^1]。 以下是导致该问题的一些常见原因： 1. **路径配置错误** Jenkins任务中配置的远程执行路径不正确，可能是`Remote Directory`设置错误，或者是构建步骤中指定的脚本路径与实际远程服务器上的路径不一致。确保所有涉及的路径都准确无误，包括脚本文件所在的目录和执行命令的相对/绝对路径。 2. **环境变量问题** Jenkins通过SSH连接到远程主机后，默认使用的环境变量可能与用户手动登录时不同。某些情况下，PATH环境变量未正确设置，导致系统无法识别需要执行的命令。可以通过在远程脚本中使用绝对路径来调用命令，或者显式地在脚本中设置PATH以避免此类问题。 3. **缺少必要的可执行权限** 如果尝试执行的脚本或程序没有赋予执行权限，则也会引发类似的错误。请确认目标文件具有适当的权限，例如使用`chmod +x script.sh`为脚本添加执行权限。 4. **SSH连接后的初始目录问题** SSH连接到远程主机后，默认的工作目录可能不是预期的位置。如果任务依赖于特定的当前工作目录，应明确更改到正确的目录后再执行相关操作。可以在执行命令前加上`cd /correct/path &&`来切换目录。 5. **脚本本身存在问题** 脚本内部可能存在语法错误或其他运行时问题，虽然这通常不会直接导致127错误，但如果脚本的第一行指定了不存在的解释器（如#!/usr/bin/python3而系统中没有安装Python3），也可能触发此错误。检查脚本开头的shebang是否指向有效的解释器。 6. **符号链接或文件缺失** 若脚本或程序依赖于某些软链接或外部文件，这些资源缺失也可能间接导致命令无法找到的问题。确保所有依赖项都已正确部署并可用。 为了排查此类问题，建议在Jenkins的日志输出中查看完整的SSH会话记录，确认实际执行的命令及其上下文环境，并在远程服务器上手动模拟相同的命令和路径进行测试，以便更快定位问题根源。 ```bash # 示例：在Jenkins SSH执行命令部分使用绝对路径确保命令可被找到 cd /var/www/myapp && /usr/bin/java -jar myapp.jar ```