在Jest中新增测试用例反而降低代码覆盖率的原因是什么

核心原因分析 #

你遇到的覆盖率下降仅发生在分支覆盖率指标上，其余行、函数、语句覆盖率均无变化，未覆盖行也保持一致，所有可能的原因如下：

• 测试状态未隔离导致原有分支覆盖丢失
  Jest默认并行执行测试用例，如果业务代码存在模块级共享变量、全局状态，新增的测试用例可能修改了共享状态，导致原有测试原本可以覆盖到的分支路径现在无法触发。由于对应代码行本身仍然被执行，所以行覆盖率不会变化，只是该代码行内的分支覆盖数减少，最终拉低整体分支覆盖率。
• 总分支统计基数变大
  如果之前的测试用例对部分内部模块做了Mock，导致这些模块的分支没有被纳入覆盖率统计基数，新增测试用例如果取消了对应Mock、导入了真实模块，Istanbul（Jest底层的覆盖率统计工具）会将这些模块的分支加入总统计基数，在没有覆盖这些新增分支的情况下，覆盖率就会出现下降。
• 异常分支执行覆盖逻辑变化
  如果新增测试用例触发了业务代码中的try/catch、Promise reject等异常分支，可能跳过了原本会执行的条件判断逻辑，导致对应分支的覆盖数减少。

排查方案 #

• 执行npx jest --runInBand强制串行执行测试，排除测试执行顺序变动导致的状态污染问题，验证覆盖率是否恢复。
• 分别单独运行原有测试集、新增测试用例，对比两次输出的分支覆盖总数、已覆盖分支数的差异，定位是覆盖数减少还是总基数变大。
• 修改Jest配置，开启分支覆盖详情输出，直接定位具体未覆盖的分支位置：

  // jest.config.js 新增配置
  coverageReporters: ["text", "text-summary", "html"]
  

  执行测试后打开coverage/Icov-report/index.html即可查看所有未覆盖的分支明细。

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