如何解决Python项目SonarCloud覆盖率统计包含测试文件夹的问题？

1. 修正pytest覆盖率生成命令 #

当前--cov参数未指定覆盖范围，会默认统计所有被pytest扫描到的文件（包括测试文件），导致覆盖率被拉低。修改命令，明确指定仅覆盖目标源码目录，并排除其中的tests子目录：

python -m pytest SonarTestProject\tests -m "%filter%" --junitxml=tests_results\test_results.xml --cov=SonarTestProject/SonarTestProject --cov-exclude="*/tests/*" --cov-report=xml:tests_results\coverage.xml --cov-branch --suppress-tests-failed-exit-code || exit /B 2

• --cov=SonarTestProject/SonarTestProject：指定仅统计该目录下的文件覆盖率
• --cov-exclude="*/tests/*"：排除该目录下的所有tests子目录文件

2. 调整SonarCloud Prepare任务配置 #

在extraProperties中添加sonar.sources、sonar.tests和sonar.exclusions，明确分析范围，避免重复索引问题：

- task: SonarCloudPrepare@1
  inputs:
    SonarCloud: 'SonarCloud - abc'
    organization: 'abc-company'
    scannerMode: CLI
    configMode: manual
    cliProjectKey: 'SonarTestProject-2023'
    cliProjectName: 'SonarTestProject'
    extraProperties: |
     sonar.python.coverage.reportPaths=$(System.DefaultWorkingDirectory)/tests_results/coverage.xml
     sonar.sources=SonarTestProject/SonarTestProject
     sonar.tests=SonarTestProject/SonarTestProject/tests
     sonar.exclusions=**/tests/**

参数说明： #

• sonar.sources：指定Sonar分析的源码根目录，仅包含需要统计覆盖率的业务代码
• sonar.tests：指定测试文件目录，让Sonar识别这些是测试代码，不纳入覆盖率统计的目标
• sonar.exclusions：明确排除所有tests目录下的文件，确保不会被误作为源码分析

3. 验证配置有效性 #

1. 重新运行Pipeline，生成新的coverage.xml，检查报告中是否仅包含api/utils.py、api/sql.py、mail.py这些业务文件的覆盖率数据
2. 查看SonarCloud面板，确认覆盖率指标是否接近预期的65%，且无can't be indexed twice报错

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