SonarQube集成NodeJS：如何展示Mocha单元测试仪表盘

我之前在把Mocha+nyc和SonarQube集成时，也碰到过覆盖率能正常展示，但单元测试指标（用例数、通过率等）缺失的情况，用mocha-junit-reporter生成JUnit XML报告确实是正确的方向，下面是我亲测有效的完整步骤：

1. 安装并配置mocha-junit-reporter #

首先确保依赖安装到位：

npm install mocha-junit-reporter --save-dev

然后修改package.json里的测试脚本，指定生成JUnit格式的测试报告：

{
  "scripts": {
    "test": "mocha --reporter mocha-junit-reporter --reporter-options mochaFile=./test-results.xml"
  }
}

这里的mochaFile参数指定了XML报告的输出路径，你可以根据项目结构调整，比如放到./reports/test-results.xml

2. 配置SonarQube扫描参数 #

在项目根目录的sonar-project.properties（如果没有就新建）里添加以下配置，告诉SonarQube去哪里读取测试报告：

# 指定JUnit测试报告路径
sonar.javascript.junit.reportPaths=test-results.xml
# 指定测试文件所在目录
sonar.tests=test
# 匹配你的测试文件命名规则（比如.test.js或.spec.js结尾）
sonar.test.inclusions=**/*.test.js,**/*.spec.js

3. 确保扫描前先生成测试报告 #

执行Sonar扫描前，一定要先运行测试生成XML文件，否则Sonar找不到报告数据：

npm test && sonar-scanner

4. 常见坑排查 #

• 报告路径不匹配：检查sonar.javascript.junit.reportPaths的路径和mochaFile的输出路径是否完全一致，Sonar对路径大小写敏感（尤其是Linux环境）
• 测试报告无数据：运行npm test后，打开生成的XML文件，确认里面有<testsuite>、<testcase>等节点，如果是空的，说明Mocha没找到测试文件，要检查测试命令的文件匹配规则
• Sonar仪表盘未添加对应部件：即使数据被Sonar读取到了，默认仪表盘可能没展示单元测试指标，需要进入SonarQube项目的「仪表盘」→「编辑仪表盘」，添加「测试用例数」「失败测试数」等部件

按照这些步骤操作后，SonarQube的仪表盘应该就能正常显示单元测试相关指标了！

内容的提问来源于stack exchange，提问作者Oscar Reyes