Jenkins构建失败Ubuntu上怎么办

快速定位与通用排查步骤

• 在 Jenkins 项目页面进入失败的构建，点击左侧的Console Output查看完整输出，优先关注日志末尾的ERROR/FAILURE/Exception等关键行。
• 若为 Pipeline，打开Blue Ocean或Pipeline Steps，定位到失败阶段并展开该阶段的日志。
• 在 Ubuntu 服务器上查看系统日志：sudo tail -f /var/log/jenkins/jenkins.log，并用grep “关键字” /var/log/jenkins/jenkins.log检索错误线索。
• 在 Pipeline 中临时开启调试：在相关 sh 步骤前加set -x，或在 post 阶段使用archiveArtifacts保存构建日志，便于下载分析。
• 若怀疑环境问题，确认节点上的JDK、Git、构建工具链已安装且路径正确。

常见场景与修复方案

• SSH 分发或远程执行失败（如“Exec exit status not zero. Status [1]”）

  • 检查目标机 SSH 服务：sudo systemctl status ssh，必要时sudo systemctl start ssh并设置开机自启。
  • Ubuntu 22.04 上若使用较旧密钥或客户端，编辑**/etc/ssh/sshd_config**，在末尾添加：
    • HostKeyAlgorithms +ssh-rsa
    • PubkeyAcceptedAlgorithms +ssh-rsa
      保存后重启 SSH：sudo systemctl restart ssh，再触发构建。
  • 同时确认 Jenkins 以具有执行权限的用户运行，远程脚本具备可执行权限且目录权限正确。

• Java AWT 相关依赖缺失（如“libawt_xawt.so: libXrender.so.1: cannot open shared object file”或“libXtst.so.6: cannot open shared object file”）

  • 安装缺失库：
    • sudo apt-get install libxrender-dev
    • sudo apt-get install libxtst6
  • 安装过程若出现图形化配置界面，按Tab选择OK确认；完成后重启 Jenkins 服务或节点使库生效。

• Maven 依赖无法解析或本地仓库缓存异常（如“Failure to find xxx.jar … was cached in the local repository”）

  • 清理 Jenkins 使用的本地仓库缓存（默认在**/var/lib/jenkins/.m2/repository**），然后重新构建，让依赖重新下载。
  • 若从其他环境拷贝仓库缓存，记得执行chown -R jenkins:jenkins /var/lib/jenkins/.m2，避免权限问题导致依赖不可用。

• 构建步骤调用的工具未安装（如“Cannot run program “phing” … error=2, No such file or directory”）

  • 在构建节点安装缺失工具，例如在 Debian/Ubuntu 上：sudo apt-get install phing，然后重试构建。

环境与权限检查清单

• 确认构建节点上已安装并正确配置JDK（版本与项目匹配），以及Git、Maven/Gradle、Node.js等所需工具；在 Jenkins 全局工具配置与节点属性中核对路径。
• 确保 Jenkins 运行用户对以下目录具备合适权限：/var/lib/jenkins（含工作空间与**.m2**）、工具安装目录、以及远程目标目录；必要时使用chown/chmod修正。
• 若使用 SSH 传输或执行脚本，确保SSH 服务运行、密钥或凭据正确、目标目录可写、脚本具备可执行权限。
• 保持系统与依赖的安全更新与兼容性（例如 Ubuntu 22.04 对权限与 SSH 算法的默认策略更严格），减少因环境变化导致的构建中断。