Nestjs项目运行Sonar scanner时sonar.coverage.exclusions配置不生效

云上老周

2026-9-25

问题根本原因

你配置的sonar.exclusions、sonar.coverage.exclusions属于SonarQube代码分析、覆盖率统计阶段的过滤规则，而你遇到的警告触发在更早的覆盖率报告解析前置校验环节：SonarScanner读取lcov.info文件时会先遍历所有记录的文件路径，校验文件是否在本地项目目录存在，这个校验步骤还没有应用你配置的排除规则，因此只要lcov.info中仍包含src/generated目录下的文件路径，就会抛出路径无法解析的警告。
tsconfig.json的exclude配置仅作用于TypeScript编译逻辑，不会影响测试覆盖率工具生成lcov报告的文件范围，因此修改该配置无法解决问题。

解决方案

最推荐方案：从覆盖率生成环节排除对应目录
修改测试框架（通常为Jest/Istanbul）的覆盖率配置，从根源上避免src/generated下的文件进入lcov报告。以Jest为例，在jest.config.js中添加如下配置：
```
module.exports = {
  // 其余原有配置保持不变
  collectCoverageFrom: [
    "src/**/*.ts",
    "!src/generated/**/*"
  ]
}
```
重新生成lcov报告后再执行Sonar扫描即可消除警告。
直接忽略lcov缺失文件警告
若不需要修改覆盖率生成规则，可在执行Sonar扫描命令时添加参数，让Scanner直接跳过缺失文件的警告校验：
```
sonar-scanner -Dsonar.login=<你的项目令牌> -Dsonar.javascript.lcov.ignoreMissingFiles=true
```
优化Sonar排除规则的路径匹配格式
把原有配置中目录全量匹配的*改为**，适配多层级子目录的匹配逻辑，避免部分场景下规则不生效：
```
sonar.exclusions=src/generated/**
sonar.coverage.exclusions=src/generated/**
```