Node.js Express服务器中nyc代码覆盖率工具无法正常工作问题排查

核心问题分析 #

你的配置和操作存在以下关键错误：

1. 禁用了代码插桩功能
   .nycrc.json 中设置了 "instrument": false，这会直接关闭 nyc 的代码插桩能力——没有插桩，nyc 无法追踪代码执行情况，自然生成空的覆盖率数据。

2. 无效的 cmd 配置
   配置里的 "cmd": "./" 是多余且错误的，这个选项用于指定测试命令（如 mocha），此处设置为当前目录没有任何意义，会干扰 nyc 的正常工作流程。

修复步骤 #

1. 修改 .nycrc.json 配置 #

更新后的配置如下（移除无效项，修正插桩设置）：

{
  "all": true,
  "cache": false,
  "check-coverage": true,
  "sourceMap": false,
  "temp-dir": "./.nyc_output",
  "include": [
    "e2e-app/src/**/*.ts",
    "server/app.js"
  ],
  "exclude": [
    "e2e-app/src/**/*.spec.ts"
  ],
  "report-dir": "./coverage-e2e",
  "reporter": [
    "lcov",
    "text",
    "text-summary",
    "cobertura"
  ],
  "branches": 80,
  "lines": 80,
  "functions": 80,
  "statements": 80,
  "watermarks": {
    "statements": [70, 100],
    "branches": [70, 100],
    "functions": [70, 100],
    "lines": [70, 100]
  }
}

2. 重新执行覆盖率统计 #

• 确保已安装 nyc：npm install nyc --save-dev
• 启动服务器并收集数据：nyc node server/app.js
• 访问 http://localhost:3000 触发路由代码执行
• 使用 Ctrl+C 正常终止服务器进程（nyc 会在进程退出时自动写入覆盖率数据）
• 生成报告：nyc report

此时你应该能在 coverage-e2e 目录下看到完整的覆盖率报告。

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