SonarQube覆盖率为0怎么排查 SonarQube覆盖率报告路径怎么填

SonarQube里覆盖率显示为0，很多时候不是测试根本没跑，而是覆盖率报告没有在扫描前生成、扫描器没找到文件、报告格式和参数名不匹配，或者报告里的路径和当前项目根目录对不上。官方文档写得很明确，SonarQube本身不会生成覆盖率报告，它只负责导入外部工具生成的报告，所以排查顺序一定要先看报告有没有生成，再看扫描器有没有正确读到。

一、SonarQube覆盖率为0怎么排查

覆盖率为0时，不要先在平台界面里反复刷新，先把排查拆成四步，先查报告有没有生成，再查生成时机对不对，再查参数名和格式对不对，最后再查路径和项目根目录是否一致。只要这四层里有一层没对上，SonarQube就可能正常完成扫描，但覆盖率仍然显示为0。

1、先确认测试工具确实生成了覆盖率报告

官方文档强调，覆盖率报告必须由外部工具先生成，再由扫描器导入；如果你的构建里只跑了测试，没有产出XML、LCOV、OpenCover或JaCoCo这类正式报告文件，SonarQube里就不会有覆盖率数据。

2、再确认报告生成发生在扫描之前

官方文档对构建顺序要求很明确，覆盖率工具必须在扫描器生成分析报告之前运行；也就是说，先跑测试并产出覆盖率文件，再执行sonar-scanner或对应语言扫描，顺序反了，覆盖率通常就是0。

3、再查你填的参数名是不是当前语言对应那一个

SonarQube不同语言对应的覆盖率参数不同，Java常用的是sonar.coverage.jacoco.xmlReportPaths，JavaScript和TypeScript常用的是sonar.javascript.lcov.reportPaths，Python常用的是sonar.python.coverage.reportPaths，C#常见的是sonar.cs.opencover.reportsPaths、sonar.cs.vscoveragexml.reportsPaths或sonar.cs.dotcover.reportsPaths。参数名填错，报告即使存在，也不会被导入。

4、再看报告格式是不是和参数匹配

官方参数页写得很清楚，不同参数对应不同报告格式，例如JaCoCo要XML，JavaScript和TypeScript要LCOV，Python要Cobertura XML，C#不同参数对应OpenCover、VS Coverage XML或dotCover。如果你拿LCOV去填JaCoCo参数，或拿HTML报告去填XML参数，覆盖率基本就会是0。

5、最后查路径是不是相对项目根目录写对了

SonarQube官方说明，除非特别注明，大多数覆盖率路径属性都要求相对项目根目录填写；如果你在本地机器、CI工作目录或多模块工程里把相对根写错，扫描器就可能找不到报告文件。

二、SonarQube覆盖率报告路径怎么填

路径怎么填，关键不是把文件名抄进去，而是先确认当前项目根目录在哪里，再确认这个参数支不支持通配符，最后再决定是填单文件、目录通配，还是逗号分隔多个路径。官方参数页已经把这些规则写得很细，尤其强调了相对路径和通配符支持范围。

1、先按项目根目录写相对路径

最稳的写法是从项目根目录出发写相对路径，例如coverage.xml、coverage/lcov.info、target/site/jacoco/jacoco.xml这一类，避免直接写本机绝对路径后在CI里失效。官方说明也明确指出，多数属性值默认是相对项目根目录。

2、通用格式才用sonar.coverageReportPaths

如果你导入的是Generic test data格式，就用sonar.coverageReportPaths；如果你用的是语言专属格式，就不要混用这个通用参数，而应直接填对应语言的专用参数。

3、Java项目优先填JaCoCo XML路径

Java、Kotlin、Scala这类JVM项目，官方给出的主参数是sonar.coverage.jacoco.xmlReportPaths，而且支持多个路径和通配符。旧的sonar.jacoco.reportPaths已经废弃，不建议再继续使用。

4、前端项目优先填LCOV路径

JavaScript和TypeScript项目常用sonar.javascript.lcov.reportPaths，值通常写成单个或多个lcov.info路径；这类路径可以是绝对路径，也可以是相对项目根的路径。

5、Python项目除了填路径，还要注意报告内部路径

Python官方示例里特别提到coverage.py生成XML时建议启用relative_files=True，这样生成的覆盖率结果更容易被SonarQube正确解析。也就是说，Python覆盖率为0时，不仅要看xml文件在不在，还要看报告里的文件路径是不是相对化了。

三、SonarQube覆盖率导入怎么复核

把路径填完并不代表就一定导入成功，最稳的做法是每次改完都按同一套清单复核。先看构建产物里有没有报告文件，再看扫描参数是不是当前语言的正式参数，再看路径是否相对项目根，最后再看本次扫描是不是发生在报告生成之后。只要这几项都固定下来，后续多模块项目、CI流水线和本地复现都会稳定很多。

1、先保留一份构建后的原始覆盖率文件

不要只看SonarQube页面，构建结束后先确认原始XML或LCOV文件真实存在，并把它作为排查基线留档。

2、再把参数写进统一配置文件或CI模板

同一项目里，覆盖率参数最好固定写进sonar-project.properties、Gradle、Maven或CI模板，不要每次手工临时拼。这样最能减少路径写错和参数混用。

3、语言切换或工具切换时先改参数再改路径

例如从JaCoCo切到Generic test data，或者从Coverlet改成VS Coverage XML时，优先改的是参数名和报告格式，不是只改文件名。否则最容易出现文件有了、路径也对，但平台仍是0覆盖率。

4、批量项目先固定一种覆盖率导入口径

同一团队里尽量不要有的项目用Generic，有的项目用语言专属参数，还夹杂旧参数，否则后面统一排查会很乱。先统一口径，维护成本会低很多。

总结

SonarQube覆盖率为0怎么排查，最稳的顺序是先查报告有没有生成，再查生成时机，再查参数名和报告格式，最后查路径是否相对项目根目录填写正确。SonarQube覆盖率报告路径怎么填，核心是按语言选对参数，再按项目根目录写相对路径，必要时结合通配符和多路径。把这套顺序固定下来后，覆盖率导入问题大多都能很快收住。