You need to enable JavaScript to run this app. 如何在Jenkins中运行单元测试并生成可查看的单元测试报告
优惠活动
大模型
产品
解决方案
定价
更多

如何在Jenkins中运行单元测试并生成可查看的单元测试报告

现有流水线优化方案

首先你的现有流水线逻辑是正确的,缺少的是测试报告收集和可视化的配置步骤,按照以下两个常用方案配置即可:

前置准备

先确保你的npm run test命令可以生成标准格式的测试报告:

  • 如果使用Jest,安装jest-junit依赖后,将test命令修改为npm run test -- --reporters=default --reporters=jest-junit,运行后会在根目录生成junit.xml文件
  • 如果使用Vitest,开启reporter: ['junit', 'html']配置,会同时生成JUnit格式xml报告和网页版HTML报告

方案1:使用JUnit插件展示测试统计数据(推荐优先配置)

这是Jenkins最常用的测试报告方案,自动统计用例通过率、失败用例详情、历史运行趋势,配置完成后任务侧边栏会出现「测试结果」入口。

配置步骤

  1. 进入Jenkins插件管理,确认已安装JUnit插件(默认预装,未安装手动安装即可)
  2. 修改你的流水线配置如下:
pipeline {
    agent any

    stages {
        stage("Build") {
            steps {  
                echo 'Building the application...'
            }
        }
        
        stage ('Unit test') {
            steps {     
                sh 'npm run test'
                // 收集JUnit格式测试报告
                junit testResults: '**/junit.xml', allowEmptyResults: false, keepLongStdio: true
            }
        }
                
        stage ("Deploy") {
            steps {  
                echo 'Deploying the application...'
            }
        }   
    }
}

参数说明

  • testResults:填写你生成的junit.xml文件路径,**/代表递归查找所有子目录
  • keepLongStdio:保留测试的完整控制台输出,方便排查失败用例
  • 默认情况下单元测试失败时,流水线会终止在当前阶段,不会执行后续部署步骤,符合正常CI流程要求

方案2:使用HTML Publisher插件展示完整网页版报告

如果需要查看带样式的完整测试报告、覆盖率报告,可使用该方案,配置完成后任务侧边栏会出现你自定义名称的报告入口。

配置步骤

  1. 进入Jenkins插件管理,安装HTML Publisher插件
  2. 确认测试命令运行后生成了HTML报告目录(比如Vitest默认生成在test-report目录,入口为index.html)
  3. 在Unit test阶段新增报告发布步骤,修改后的流水线示例:
pipeline {
    agent any

    stages {
        stage("Build") {
            steps {  
                echo 'Building the application...'
            }
        }
        
        stage ('Unit test') {
            steps {     
                sh 'npm run test'
                // 收集JUnit统计报告
                junit testResults: '**/junit.xml', allowEmptyResults: false, keepLongStdio: true
                // 发布HTML格式完整报告
                publishHTML (
                    target: [
                        allowMissing: false,
                        alwaysLinkToLastBuild: true,
                        keepAll: true,
                        reportDir: 'test-report', // 替换为你实际的HTML报告目录路径
                        reportFiles: 'index.html',
                        reportName: '单元测试完整报告'
                    ]
                )
            }
        }
                
        stage ("Deploy") {
            steps {  
                echo 'Deploying the application...'
            }
        }   
    }
}

样式异常解决

Jenkins默认的安全策略会拦截HTML报告的CSS、JS加载,导致报告样式丢失,可进入Jenkins系统管理→脚本控制台,执行以下代码后重启Jenkins即可修复:

System.setProperty("hudson.model.DirectoryBrowserSupport.CSP", "")

注意事项

  • 所有文件路径需和你项目实际生成的报告路径一致,不确定路径时可在Unit test阶段新增sh 'ls -R'命令打印工作目录文件结构确认
  • 两种方案可同时配置,同时查看测试统计数据和完整网页报告

内容的提问来源于stack exchange,提问作者Saaya

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.15 22:45:03