本地与CI环境pytest coverage报告差异排查求助

针对你遇到的本地覆盖率报告75%、CI徽章显示21%的差异问题，可以从以下几个方向逐一排查：

1. 覆盖率统计范围不一致 #

• 对比本地和CI的coverage执行命令：本地通过make report触发，依赖test目标，需确认CI中是否使用了相同的coverage run参数。比如本地是否指定了--source参数限定统计范围（如coverage run --source='.' manage.py test），而CI中未设置，导致统计了venv、migrations等无关文件拉低覆盖率。
• 检查.coveragerc配置：本地和CI环境是否加载了相同的配置文件，确认include/exclude规则是否一致（比如是否排除了migrations/、admin.py等文件，两边规则是否同步）。

2. 测试用例执行范围差异 #

• 确认CI中测试命令的执行范围：本地执行make test是否跑了全量测试，而CI的test.yml中是否只指定了部分app或测试文件（如manage.py test app_name），导致未覆盖全部代码。
• 检查CI中测试用例是否被跳过：查看CI日志，是否存在依赖缺失、环境变量配置不同导致的测试用例跳过（比如某些需要第三方服务的用例在CI中未mock，直接跳过）。

3. 覆盖率报告上传与徽章数据源问题 #

• 检查CI中覆盖率报告上传工具的配置：上传时是否添加了过滤规则，导致部分文件的覆盖率未被统计；或者上传命令的参数与本地生成报告的参数不匹配。
• 确认徽章的数据源是否为最新CI结果：部分徽章服务存在缓存延迟，可手动触发CI重新运行，查看徽章是否更新。

4. 环境差异导致代码路径未执行 #

• 对比本地与CI的Django Settings：比如DEBUG模式、功能开关等配置是否一致，某些代码分支可能因环境配置不同在CI中未被触发执行（如DEBUG=False时跳过的调试代码）。
• 核对依赖版本：本地和CI环境的coverage、Django等依赖版本是否一致，不同版本的coverage统计逻辑可能存在差异，导致结果不同。

另外，建议在CI中添加coverage report命令的输出日志，直接查看CI环境下的覆盖率统计详情，对比本地报告的文件列表，就能快速定位哪些文件在CI中未被覆盖，从而找到差异根源。

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