SonarQube不识别pytest覆盖率是因为其只解析coverage.xml（Cobertura格式）而非JUnit XML，需用pytest-cov --cov --cov-report=xml生成，并确保路径、源码映射及配置项（如sonar.sources、sonar.python.coverage.reportPaths）完全匹配。
pytest生成JUnit XML报告时为什么SonarQube不识别覆盖率？
因为SonarQube默认只从coverage.py的.coverage文件或coverage.xml（Cobertura格式）读取覆盖率，而pytest本身不生成覆盖率报告——必须显式集成pytest-cov，且输出格式要匹配SonarQube要求。
- 运行命令必须同时启用
--cov和--cov-report=xml，不能只用--junitxml -
--cov-report=xml生成的是coverage.xml（Cobertura格式），这是SonarQube Java/Python插件的标准输入，不是JUnit格式 - JUnit XML（由
--junitxml生成）只含测试结果，不含行覆盖、分支覆盖等质量指标，SonarQube用它判断测试通过率，但不用于计算覆盖率 - 确保
pytest-cov版本 ≥ 4.0，旧版生成的coverage.xml可能缺少line-rate等SonarQube解析必需字段
sonar-project.properties里哪些配置项最容易写错？
配置错误会导致SonarQube扫描跳过源码、找不到测试报告或忽略覆盖率——尤其注意路径拼写和前缀一致性。
-
sonar.sources=.或sonar.sources=src：必须指向实际Python源码目录，不能是tests/或空值；若项目结构为src/mylib/，这里就得写src -
sonar.tests=tests：仅用于指定测试目录位置，不影响报告解析，但影响“测试文件”元数据归类 -
sonar.python.coverage.reportPaths=coverage.xml：路径是相对于sonar-project.properties所在目录的，不是相对于项目根；若XML在htmlcov/coverage.xml，就得写htmlcov/coverage.xml -
sonar.junit.reportPaths=pytest-results.xml：必须与pytest --junitxml=pytest-results.xml中文件名完全一致，区分大小写，且不能有空格或中文 - 漏掉
sonar.language=python会导致SonarQube按通用规则解析，可能跳过Python专用规则（如pylint类规则）
CI流水线里执行sonar-scanner总报“Unable to read file ‘coverage.xml’”怎么办？
根本原因通常是文件生成路径与sonar-project.properties中声明的路径不一致，或者生成步骤被跳过。
python-script-generator
下载
快速生成专业的 Python 脚本和应用代码。一键创建完整项目结构，支持CLI、API、爬虫、Bot、Django等多种项目类型，包含完整的项目结构、配置文件、依赖管理、测试、README和文档。
- 确认
pytest命令是否真执行了：CI日志里搜coverage.py或Collected关键字，避免因pytest没找到测试用例而静默退出 - 检查
coverage.xml是否真的存在：在sonar-scanner执行前加一句ls -l coverage.xml或cat coverage.xml | head -n 5 - GitLab CI/ GitHub Actions中常见陷阱：
sonar-scanner运行在另一个job或container里，而coverage.xml没通过artifacts或cache传递过去 - Windows环境下路径分隔符问题：CI用Linux runner但本地开发用Windows，导致
sonar.python.coverage.reportPaths里写了.\coverage.xml——一律用正斜杠/ - 权限问题：某些CI环境（如Docker容器）里
coverage.xml由root生成，但sonar-scanner以非root用户运行，加chmod 644 coverage.xml保险
为什么SonarQube显示“0% coverage”即使coverage.xml里有数据？
多半是源码路径映射失败——SonarQube拿coverage.xml里的filename字段去匹配sonar.sources下的文件，路径不一致就无法关联。
立即学习“Python免费学习笔记（深入）”；
- 打开
coverage.xml，看<package name="..."><class name="..." filename="xxx.py">里的filename值，比如mylib/utils.py - 对比
sonar.sources设置：如果设的是src，那coverage.xml里期望的路径应为src/mylib/utils.py；若实际是mylib/utils.py，说明pytest-cov没配置--cov-config或pyproject.toml里source路径不对 - 推荐在
pyproject.toml里统一控制：[tool.coverage.run] source = ["src"] omit = ["*/tests/*", "*/test_*.py"]
，这样pytest --cov --cov-report=xml生成的filename就会带src/前缀 - SonarQube社区版不支持多源路径（如
sonar.sources=src,tests），若代码分散，得用sonar.exclusions过滤非源码，再把所有源统一放在一个目录下
coverage.xml内容与sonar-project.properties的路径逻辑是否自洽。 
