Jest代码覆盖率报告为空，未读取到业务文件怎么办？

你遇到的业务文件未被纳入Jest覆盖率统计、报告完全空白的问题，核心源于Jest的覆盖率收集默认规则，结合你给出的配置和项目结构，具体排查解决步骤如下：

核心逻辑说明 #

Jest 26及以上版本不会主动遍历整个项目目录收集所有业务代码做覆盖率统计，默认只会收集两类文件：

• 被测试文件主动通过require/import加载到测试环境中的业务文件
• 通过配置显式指定纳入统计范围的文件
  你的当前Jest配置完全没有声明覆盖率收集范围规则，自然会出现报告空白的问题。

现有配置的缺失问题 #

看你当前package.json中的Jest配置块：

"jest": {
    "testEnvironment": "node",
    "coveragePathIgnorePatterns": [
        "/node_modules"
    ]
}

这里缺少了最关键的collectCoverageFrom字段——这个字段就是用来告诉Jest「哪些文件需要被纳入覆盖率统计」的规则。没有这个配置，就算你的测试能正常跑，只要测试和业务文件的加载关联没被Jest识别，就会出现覆盖率报告空白的情况。

具体修正步骤 #

• 补全collectCoverageFrom配置，根据你的项目实际文件结构指定收集范围。结合常规后端项目的目录布局，可参考如下配置：

  "jest": {
      "testEnvironment": "node",
      "collectCoverageFrom": [
          "src/**/*.js",
          "!**/node_modules/**",
          "!**/__tests__/**",
          "!server.js",
          "!seeder.js"
      ],
      "coveragePathIgnorePatterns": [
          "/node_modules"
      ]
  }
  

  这个配置的作用是：收集src目录下所有JS格式的业务代码，排除第三方依赖目录、测试文件本身、服务入口、数据库种子脚本这类不需要统计单元覆盖率的文件。如果你的业务代码直接放在项目根目录而非src文件夹下，把收集规则调整为./*.js即可。
• 排查测试文件的导入链路问题
  部分场景下，测试文件因为相对路径写错，导致实际没有加载到真实的业务模块，只是加载了空的mock对象；甚至部分测试文件本身就没有主动导入任何业务代码，只是写了独立的测试逻辑。这种情况就算补了收集规则，Jest也无法统计到真实的代码执行情况。可以在测试文件里临时打印导入的业务模块对象，确认拿到的是真实的业务代码导出，而非空值。
• 确认覆盖率命令的执行方式
  你当前配置的"coverage": "npm test -- --coverage"命令逻辑是正确的，执行时不要额外加--watch类的常驻监听参数，避免报告无法正常生成写入。

常见踩坑提醒 #

• 不要把测试文件本身的路径放到collectCoverageFrom的收集规则里，不然测试代码的执行路径会干扰真实业务代码的覆盖率统计结果
• 如果你使用了ES Module的import/export语法，要确认Jest的语法转译配置匹配你的代码规范，避免文件加载失败导致覆盖率收集失效

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