Jenkins作业执行正常但状态显示失败问题求助

我之前维护Jenkins流水线时碰到过完全一样的情况：Ansible Playbook明明按预期执行完了，结果Publish over SSH插件直接返回错误导致作业失败，把整个流水线都卡住了。给你几个实际试过有效的排查和解决思路：

1. 先盯紧Ansible的退出码 #

Publish over SSH插件对远程命令的退出码要求特别严格——哪怕Playbook逻辑全跑通了，只要某个步骤返回非零值（比如任务被跳过、出现警告），插件都会直接判定作业失败。

Ansible本身的退出码有特殊含义：

• 0：所有任务执行成功
• 2：有任务被跳过（这在很多场景下是正常情况，比如某些条件不满足跳过任务）
• 其他非零值：真的有任务执行失败

你可以在执行Playbook的命令里手动处理这些退出码，确保最终返回插件认可的0值，比如：

ansible-playbook your_deploy_playbook.yml
PLAYBOOK_EXIT=$?
# 允许退出码0（成功）和2（跳过任务），返回0让插件认为执行成功
if [ $PLAYBOOK_EXIT -eq 0 ] || [ $PLAYBOOK_EXIT -eq 2 ]; then
    exit 0
else
    # 真正的失败还是要返回原退出码，方便排查
    exit $PLAYBOOK_EXIT
fi

2. 检查Publish over SSH的插件配置 #

打开Jenkins作业里的Publish over SSH配置，看看这两个关键点：

• Fail on error选项：如果这个选项开启了，只要远程命令返回任何非零退出码，插件就会报错。如果你确定某些非零退出是安全的（比如Ansible的退出码2），可以考虑关闭这个选项，但更稳妥的是用上面的方法处理退出码。
• Exec command的命令链：如果你的命令是多个步骤用&&连接的，前面的命令失败会直接终止整个流程；如果用分号;连接，插件会取最后一个命令的退出码。确认你的命令链逻辑是否正确。

3. 查看完整的错误日志 #

你提供的日志被截断了，赶紧去Jenkins作业的完整日志里找Exec exit status后面的具体数值——这个数值是关键：

• 如果是2：那就是上面说的Ansible跳过任务导致的，用退出码处理脚本就能解决。
• 如果是1或其他非零值：那可能是Playbook里某个任务隐性失败了（比如日志没显示全），或者文件传输后权限不对、依赖缺失，这时候要去远程服务器上看Ansible的详细日志（比如/var/log/ansible.log，如果配置了日志输出的话）。

4. 验证文件传输后的状态 #

有时候文件传输完成后，文件的权限或所有者不对，导致Playbook执行时虽然日志显示“成功”，但实际有未捕获的错误。你可以在执行Playbook前加一步命令，检查传输文件的权限：

ls -l /path/to/transferred/files

确保这些文件的权限符合Playbook的要求（比如需要可执行、属于特定用户组）。

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