将Perl模块上传至CPAN后测试覆盖率缺失问题求助

问题背景 #

Test::Expander模块上传CPAN后，测试报告全部正常，但模块详情页左侧栏（Bus factor与License之间）的测试覆盖率信息未显示；本地沙箱测试覆盖率达100%，且CPAN覆盖报告平台已生成该模块的覆盖率数据。

可能的原因及排查方向 #

• CPAN页面索引同步延迟：CPAN模块详情页的侧边栏数据并非实时更新，覆盖率数据从生成到关联显示通常需要数小时甚至1-2天的同步周期，可等待一段时间后再次检查页面。
• 覆盖率数据关联失败：CPAN覆盖报告平台生成的数据可能因模块命名不匹配（如大小写偏差、命名空间拼写错误），无法与你的模块详情页关联，可检查平台上的模块名称是否与CPAN页面完全一致。
• Makefile.PL配置的隐性问题：虽然{ test }->{ TESTS }的测试路径配置看似正常，仍需确认：
  • 是否在Makefile.PL中正确声明了所有需要统计覆盖率的核心代码文件，无遗漏；
  • 是否存在自定义测试逻辑（如跳过某些测试阶段、修改测试环境）干扰了覆盖率收集脚本的执行；
• CPAN测试环境的覆盖率收集限制：部分CPAN测试节点可能未启用覆盖率统计任务，或你的模块依赖的特定环境（如Perl版本、第三方库）导致覆盖率工具无法正常运行，即使本地测试无问题，线上环境可能存在兼容性问题。
• 模块元数据不全：检查模块的META.json或META.yml文件，确保provides字段完整包含所有需要覆盖的代码文件路径，CPAN页面依赖元数据来匹配覆盖率数据。

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