Jenkins集成Newman生成的HTML报告无法正常显示求助

问题场景 #

我在JenkinsFile中定义了如下流水线步骤生成HTML报告：

stage('Run Integration Tests') {
    steps {
                dir("${env.WORKSPACE}/test/integration") {
                    sh'''
                        npm install -g newman
                        npm install -g newman-reporter-htmlextra
                        newman run postman_collection.json -e ''' +APIGEE_ENVIRONMENT+'''.postman_environment.json --reporters cli,htmlextra --reporter-htmlextra-export "newman_result.html"
                    '''
                }
    }
}

随后尝试发布该报告，但报告始终显示为空白HTML页面：

stage('Artifacts') {
    steps {
        publishHTML(target: [
            alwaysLinkToLastBuild: false,
            allowMissing: false,
            keepAll: true,
            reportDir: "${WORKSPACE}",
            reportFiles: 'newman_result.html',
            reportName: 'Integration Test Results',
            reportTitles: ''
        ])
    }
}

问题原因 #

1. 路径不匹配：报告实际生成在${env.WORKSPACE}/test/integration目录下，但发布阶段的reportDir配置为${WORKSPACE}，Jenkins无法正确定位到报告文件；即使偶然找到文件，报告依赖的CSS、JS等静态资源路径也会失效，导致页面渲染空白。
2. 全局安装依赖风险：全局安装newman和newman-reporter-htmlextra可能存在权限或环境路径问题，导致报告生成不完整。

解决方案 #

方案1：修正报告发布路径 #

修改Artifacts阶段的reportDir，指向报告实际生成的目录：

stage('Artifacts') {
    steps {
        publishHTML(target: [
            alwaysLinkToLastBuild: false,
            allowMissing: false,
            keepAll: true,
            reportDir: "${env.WORKSPACE}/test/integration",
            reportFiles: 'newman_result.html',
            reportName: 'Integration Test Results',
            reportTitles: ''
        ])
    }
}

方案2：使用本地依赖替代全局安装（更推荐） #

全局安装依赖易引发环境一致性问题，改为在项目目录下安装本地依赖：

stage('Run Integration Tests') {
    steps {
                dir("${env.WORKSPACE}/test/integration") {
                    sh'''
                        # 安装项目本地依赖
                        npm install newman newman-reporter-htmlextra
                        # 通过npx调用本地安装的newman
                        npx newman run postman_collection.json -e ''' +APIGEE_ENVIRONMENT+'''.postman_environment.json --reporters cli,htmlextra --reporter-htmlextra-export "newman_result.html"
                    '''
                }
    }
}

同时配合方案1的路径修正，确保发布阶段能正确加载报告及依赖资源。

额外检查点 #

• 确认postman_collection.json和对应环境文件存在于test/integration目录下，避免newman执行失败生成空报告。
• 查看Jenkins构建日志，确认newman命令是否成功执行、报告文件是否正常生成。

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