如何在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最常用的测试报告方案,自动统计用例通过率、失败用例详情、历史运行趋势,配置完成后任务侧边栏会出现「测试结果」入口。
配置步骤
- 进入Jenkins插件管理,确认已安装
JUnit插件(默认预装,未安装手动安装即可) - 修改你的流水线配置如下:
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插件展示完整网页版报告
如果需要查看带样式的完整测试报告、覆盖率报告,可使用该方案,配置完成后任务侧边栏会出现你自定义名称的报告入口。
配置步骤
- 进入Jenkins插件管理,安装
HTML Publisher插件 - 确认测试命令运行后生成了HTML报告目录(比如Vitest默认生成在
test-report目录,入口为index.html) - 在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
相关产品推荐
相关产品推荐

