Jenkins 的 Pipeline 构建中查看失败原因和日志的方法和步骤

1. 在 Jenkins Web 界面查看构建日志

1)进入失败的构建

• 打开你的 Jenkins 项目页面。
• 点击 Build History（构建历史）中的最近失败的构建（一般标有红色 “x”）。

2)查看控制台输出

• 点击左侧菜单的 Console Output。
• 在这里可以看到从构建开始到失败的完整日志，包括每个步骤的输出内容和错误信息。
  
  

3) 关键日志信息

• 通常失败原因会标注在日志的最后几行（例如，Exception 信息、Stack Trace 或错误消息）。
• 搜索类似 ERROR、FAILURE 或 Exception 的关键词以定位问题。

2. 在 Pipeline 可视化界面中定位失败的阶段

1)进入 Pipeline 图表界面

如果你的 Pipeline 启用了可视化界面（例如有阶段分层图），点击 Pipeline Steps。

2)查看具体阶段的日志

点击失败阶段（通常显示红色标志）。
在下方展开 Logs 以查看该阶段的输出和错误信息。

3. 使用 Archive the Artifacts 保存日志文件

如果构建日志太长，无法在控制台输出中完全查看，可以通过保存日志文件来分析。

在 Pipeline Script 中添加以下内容：

post {
    always {
        archiveArtifacts artifacts: 'build/logs/*.log', allowEmptyArchive: true
    }
}

然后：

将构建的详细日志保存为文件（路径可自定义）。
在 Jenkins 构建页面的 Artifacts 部分下载日志文件并查看。

4. 通过邮件获取构建日志

如果已设置邮件通知，可以在邮件中附加日志的部分内容。

post {
    failure {
        emailext(
            to: 'developer@example.com',
            subject: "Build Failed - ${env.JOB_NAME}",
            body: """
                Build ${currentBuild.fullDisplayName} failed.
                Check the console output: ${env.BUILD_URL}/console
                Logs:
                ${currentBuild.rawBuild.log(50)} // 仅附加前50行日志
            """
        )
    }
}

5. 使用 Jenkins Blue Ocean 查看日志

如果安装了 Blue Ocean 插件：

点击 Blue Ocean，进入更友好的 Pipeline 可视化界面。
定位失败的阶段，并查看详细日志。

6. 调试失败原因

根据日志提示：

• 如果是构建脚本问题：

检查错误发生的步骤对应的脚本代码。
修正相关命令或脚本。

• 如果是环境问题：

确保 Jenkins Agent 上的依赖环境（如 JDK、Git）安装正确。
检查是否缺少工具或路径错误。

• 如果是网络或权限问题：

确保 GitLab 或其他外部服务可以正常访问。
检查凭据是否正确配置。

7. 运行调试模式

如果无法通过日志快速定位问题，可以开启更多详细日志：

在 Pipeline 中设置 sh 或 bat 脚本的调试模式，例如：

pipeline {
    agent any
    stages {
        stage('Debug') {
            steps {
                sh 'set -x && ./your-script.sh' // Linux/Unix 调试模式
            }
        }
    }
}

set -x 会输出每个命令及其执行结果，帮助更好地调试问题。

通过以上方法，你应该能够快速定位 Jenkins 构建失败的原因，并采取相应措施进行修复。如果日志仍无法帮助定位问题，请提供详细日志或错误信息，我可以协助进一步分析。