sonarQube里覆盖率一直是0，通常不是平台不会算，而是覆盖率报告没有被导入，或报告里记录的文件路径和本次扫描识别到的源码路径对不上。排查时先确认报告有没有生成，再确认扫描器能不能读到，最后再看映射口径是否一致，把这三步跑通，问题一般就能闭环定位。

　　一、sonarQube覆盖率一直显示为0怎么办

　　覆盖率为0要先判断是报告缺失还是映射失败，再按从外到内的顺序排查，避免一上来就反复改参数却没有证据验证。

　　1、先确认覆盖率报告确实生成了

　　在CI里把步骤顺序固定为先执行测试生成覆盖率，再执行Sonar扫描；生成结束后在制品列表或工作目录里确认报告文件真实存在，常见文件是jacoco.xml或lcov.info，文件为空或未生成时后续再怎么配路径也会显示为0。

　　2、确认扫描步骤和报告在同一工作目录口径下

　　检查流水线是否在不同目录运行测试与扫描，或测试在容器里跑而扫描在宿主机跑；把扫描步骤的工作目录统一到仓库根目录，必要时在扫描前把覆盖率文件拷贝到仓库根目录下的固定位置，避免相对路径指向错误目录。

　　3、用后台任务验证本次扫描是否真的读到了报告路径参数

　　进入项目后点击【Project Information】→【Background Tasks】，打开最新一次任务详情，查看任务日志中是否出现读取覆盖率报告的提示；如果有【Show SonarScanner Context】入口，点开后搜索reportPaths或lcov，确认本次扫描实际生效的路径值与预期一致，防止界面配置与CI参数相互覆盖。

　　4、报告已读取但仍为0时优先排查源文件映射失败

　　重点看报告里记录的文件路径是否与扫描识别到的源码路径一致，常见问题是报告指向构建产物目录或绝对路径，而扫描分析的是仓库源码目录；处理时让覆盖率工具输出指向源码目录的路径口径，或把扫描根目录与生成报告的根目录统一，避免同一文件被当成两份不同路径。

　　5、检查分析范围与排除规则是否把有效源码排除了

　　进入【Project Settings】→【Analysis Scope】，核对源码目录配置与排除规则，确保核心源码没有被排除；如果源码不在分析范围内，即便报告被读取也无法落到文件上，覆盖率仍会表现为0或接近0。

　　6、先用最小模块跑通闭环再扩展到全量

　　选一个子模块或一个小工程，先跑通测试生成报告与扫描导入，确认项目首页覆盖率能变化；再逐步把其他模块的报告路径加进来，用逐步扩展的方式更容易锁定是哪一个模块的路径或映射口径有问题。

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

　　路径填写的关键是选对语言对应的参数名，并保证路径以扫描工作目录为参照可被直接找到，同时避免多处配置互相覆盖导致你以为改了却没生效。

　　1、先统一配置入口只保留一处生效

　　确定覆盖率路径是写在sonar-project.properties里，还是在CI扫描命令里传参，或在sonarQube界面里配置；排查阶段建议只保留一种方式，改完后立刻回到【Background Tasks】确认上下文里显示的参数值就是你刚设置的值。

　　2、Java项目填写JaCoCo XML报告路径

　　在项目界面进入【Project Settings】→【General Settings】→【JaCoCo】，在对应输入框填写sonar.coverage.jacoco.xmlReportPaths；路径建议用相对仓库根目录的写法，多个模块就用逗号分隔写多条路径，并确保每条路径都能在扫描节点上实际访问到文件。

　　3、JavaScript与TypeScript填写LCOV报告路径

　　进入【Project Settings】→【General Settings】→【JavaScript/TypeScript】→【Tests and Coverage】，填写sonar.javascript.lcov.reportPaths；如果你们先编译再测试，要确认lcov里记录的是源码路径而不是编译输出路径，否则导入成功也可能无法映射到源码文件。

　　4、Python填写覆盖率XML报告路径

　　进入【Project Settings】→【General Settings】→【Python】相关覆盖率设置区域，填写sonar.python.coverage.reportPaths；同样建议使用相对路径，并保证报告格式与生成工具输出一致，避免拿到不兼容的XML导致被忽略。

　　5、多模块多报告的路径写法要可验证可回退

　　把每个模块的报告路径先单独验证通过，再按同一根目录口径追加到同一个参数里，用逗号分隔；一旦合并后结果异常，可以快速回退到上一次已验证的组合，不必重新猜测。

　　6、填完后做两步自检避免低级错误

　　第一步在扫描执行机器的工作目录里直接定位到报告文件，确认路径能命中且文件非空；第二步回到【Project Information】→【Background Tasks】查看该次任务日志，确认存在导入提示并且没有找不到文件或无法解析的告警。

　　三、覆盖率从生成到展示怎么做闭环验证

　　覆盖率链路想长期稳定，必须把生成、导入、映射与门禁做成固定动作，并保留证据让问题可复现可对照。

　　1、固化一条最小闭环用例作为健康检查

　　准备一个小模块或一个代表性测试集合，每次换流水线、换容器、换扫描参数都先跑这条闭环，确保报告生成成功、扫描能读取、页面能展示，再放开全量。

　　2、把路径口径写死到仓库根目录并避免绝对路径漂移

　　尽量让覆盖率报告与扫描都以仓库根目录为参照，减少盘符、挂载点、大小写差异带来的映射失败；跨容器执行时优先用制品回传把报告放回到同一目录结构下。

　　3、把新增零覆盖作为门禁比追历史总覆盖更可执行

　　历史欠账较大时，先控制新增或改动代码不出现零覆盖或明显下降，再按模块计划逐步收敛基线违规，这样指标不会因为一次性门槛过高而失效。

　　4、每次修复都留三份证据便于复盘

　　保留本次生效的reportPaths取值截图或文本、后台任务日志中导入覆盖率的关键片段、以及覆盖率变化前后的页面截图或导出数据，后续再遇到覆盖率为0能快速对照定位。

　　5、对异常波动优先从范围与映射找原因再谈测试量

　　覆盖率突然掉到0或大幅下降时，先核对分析范围、排除规则与路径映射是否变化，再核对测试是否真正执行与报告是否生成，按先配置后数据的顺序更容易定位根因。

　　总结

　　sonarQube覆盖率一直显示为0时，先确认覆盖率报告已生成且在扫描工作目录可达，再用【Project Information】→【Background Tasks】核对本次分析是否读到报告路径与导入日志，最后排查报告路径与源码路径是否能正确映射。填写覆盖率报告路径时，按语言选择对应reportPaths参数，用相对仓库根目录的路径写法，单模块先跑通再扩展到多模块，并把最小闭环与证据留存固化下来，覆盖率展示就更稳定可复现。