SonarQube扫描遇SCM忽略文件、Node不存在、JaCoCo无覆盖率问题求助

问题1：82958个文件因SCM ignore设置被忽略 #

根因 #

SonarQube扫描默认会自动读取项目根目录下的.gitignore、.npmignore等SCM忽略规则，默认排除node_modules、构建产物、缓存文件等非业务代码，该忽略量级一般是包含了node_modules下的所有依赖文件，属于默认正常行为，仅当业务代码被误忽略时需要调整。

解决办法 #

• 优先确认被忽略文件是否均为非业务代码（如node_modules、dist、build、.git等目录），符合预期的话无需额外处理
• 如需强制关闭SCM忽略规则，在项目根目录的sonar-project.properties配置文件中添加：

  sonar.scm.exclusions.disabled = true
  

• 如需自定义扫描范围，可单独配置包含/排除路径，示例：

  # 仅扫描src目录下的业务代码
  sonar.inclusions=src/**
  # 明确排除不需要扫描的目录
  sonar.exclusions=**/node_modules/**,**/dist/**,**/public/**/*.html
  

问题2：JS/CSS分析报错，提示找不到node程序 #

根因 #

SonarQube的JavaScript/TypeScript、CSS规则检测强依赖本地Node.js环境，执行sonar-scanner的进程无法读取到系统PATH中的Node可执行文件，通常是Node未添加到全局环境变量，或者使用nvm、nvs等Node版本管理工具时，扫描终端未激活对应Node版本导致。

解决办法 #

1. 先在执行sonar-scanner的终端窗口执行node -v，确认能正常输出版本号，若失败先将Node.js安装路径添加到系统全局PATH变量：
   • Windows默认安装路径：C:\Program Files\nodejs\
   • Mac/Linux默认安装路径：/usr/local/bin/
   • 若使用nvm安装，路径为~/.nvm/versions/node/<对应版本号>/bin/
2. 若使用版本管理工具，执行扫描前先激活对应Node版本，示例：

   nvm use 18
   

3. 也可直接在sonar-project.properties中手动指定Node可执行文件路径，示例：
   • Windows：

     sonar.nodejs.executable=C:\\Program Files\\nodejs\\node.exe
     

   • Mac/Linux：

     sonar.nodejs.executable=/usr/local/bin/node
     

问题3：JaCoCo XML报告找不到，无覆盖率导入 #

根因 #

JaCoCo是Java技术栈的覆盖率统计工具，MERN栈为JS/TS技术栈，本身不需要JaCoCo报告，该告警是SonarQube默认启用JaCoCo插件导致的误报。如果需要导入JS/TS覆盖率，需使用前端测试工具生成LCOV格式的覆盖率报告，配置SonarQube读取即可。

解决办法 #

• 若不需要导入覆盖率数据，直接在sonar-project.properties中关闭JaCoCo检测即可：

  sonar.plugins.jacoco.enabled=false
  

• 若需要统计JS/TS代码覆盖率，按以下步骤操作：
  1. 项目中使用jest、vitest等单测工具配置生成LCOV报告，以jest为例，在jest.config.js中添加配置：

     module.exports = {
       coverageReporters: ["lcov"]
     }
     

  2. 执行单测命令生成覆盖率报告，示例：

     npm run test:coverage
     

  3. 在sonar-project.properties中配置LCOV报告路径，示例：

     sonar.javascript.lcov.reportPaths=coverage/lcov.info
     

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