为何SonarQube无法获取代码覆盖率？Jenkins+Mocha环境求助

我来帮你一步步排查这个代码覆盖率不显示的问题，结合你用Jenkins+Mocha+SonarQube的AngularJS/Node.js项目场景，整理几个关键排查点：

1. 确认lcov.info文件是否真实生成且有效 #

首先要排除最基础的问题：coverage/lcov.info文件是否真的存在，并且有内容。

• 在Jenkins构建完成后，进入项目工作空间，手动检查该路径下的文件是否存在。
• 如果文件存在，打开看看是否有覆盖率数据（不是空文件）。可以在Jenkins构建步骤里添加一个命令验证：

  cat coverage/lcov.info
  

  如果输出为空或者文件不存在，说明Mocha没有正确生成覆盖率报告，得先解决这个前置问题。

2. 校验SonarQube路径配置的正确性 #

SonarQube的sonar.javascript.lcov.reportPaths配置是相对于项目根目录的，要注意以下几点：

• 路径是否和实际生成的文件位置完全匹配（Linux环境下大小写敏感，别写错大小写）。
• 如果你的coverage文件夹是在子目录下（比如test/coverage），要把配置改成对应的路径：sonar.javascript.lcov.reportPaths=test/coverage/lcov.info。

3. 确保Mocha正确配置了覆盖率生成工具 #

Mocha本身不会生成覆盖率报告，需要搭配nyc（原istanbul）这类工具：

• 检查你的测试命令是否包含生成lcov报告的参数，比如：

  nyc --reporter=lcov mocha test/**/*.js
  

  这个命令会在项目根目录下生成coverage/lcov.info文件。如果只是单纯跑mocha test/**/*.js，是不会产生覆盖率文件的。

4. 检查Sonar-Scanner的执行日志 #

Jenkins构建日志里的Sonar-Scanner输出是关键线索：

• 搜索日志里的关键词，比如lcov、coverage report，看看有没有类似Could not find coverage report的错误提示，或者Processing lcov report的成功日志。
• 如果日志显示找不到报告文件，直接对应调整sonar.javascript.lcov.reportPaths的路径配置。

5. 验证SonarQube插件与版本兼容性 #

旧版本的SonarQube JavaScript插件可能存在兼容性问题：

• 登录SonarQube后台，查看已安装的JavaScript插件版本，尽量升级到最新的稳定版。
• 确保SonarQube服务器版本和JavaScript插件版本匹配（插件页面会标注兼容的SonarQube版本）。

6. 确认测试文件被SonarQube正确识别 #

SonarQube需要识别到你的测试文件，才能关联覆盖率数据：

• 检查sonar.tests=test配置的路径下，测试文件是否符合SonarQube的默认命名规则（比如*.test.js、*.spec.js）。
• 如果你的测试文件命名特殊，可以添加sonar.test.inclusions配置指定测试文件的匹配规则，比如：

  sonar.test.inclusions=test/**/*.js
  

内容的提问来源于stack exchange，提问作者Sahan Sandaruwan