Angular项目Jest覆盖率报错：无法解析lcov.info中文件路径

问题详情 #

• 使用Jest 29.5统计Angular项目单元测试覆盖率时，触发报错：

  "Could not resolve 199 file paths in [workspace/source/Content/angular-project/coverage/lcov.info]
  

• 首个无法解析的路径：Content/angular-project/src/app/app.component.html
• 当前jest.config.ts的覆盖率报告配置：

  coverageReporters: ['html', ["lcovonly", {"projectRoot": "../../"}], 'text-summary'],
  

• 尝试后仍未解决的情况：
  • 修改projectRoot为绝对路径后，lcov.info中的文件路径变为相对路径，与配置的projectRoot不匹配
  • 无论使用相对还是绝对路径，都会触发该错误
  • 公司限制无法使用sed命令修改文件

可行解决方案 #

方法1：对齐rootDir与projectRoot配置

在jest.config.ts中明确项目根目录rootDir，让projectRoot与rootDir保持一致，避免路径层级混乱：

// jest.config.ts
export default {
  rootDir: '.', // 若配置文件在项目根目录，设为'.'即可
  coverageReporters: [
    'html',
    ['lcovonly', { projectRoot: './' }], // 与rootDir匹配，确保路径解析一致
    'text-summary'
  ],
  // 其他Jest配置...
};

方法2：排除无需统计的文件（临时方案）

如果HTML模板等文件不需要统计覆盖率，可直接在配置中排除：

// jest.config.ts
export default {
  coveragePathIgnorePatterns: [
    'src/app/**/*.html', // 排除所有HTML模板文件
    // 可添加其他需要排除的路径
  ],
  // 其他Jest配置...
};

方法3：用Node.js脚本替代sed修改路径

写一个简单的Node.js脚本，在生成覆盖率后自动修正路径：

1. 在项目根目录创建fix-lcov-path.js：

const fs = require('fs');
const path = require('path');

const lcovPath = path.join(__dirname, 'coverage', 'lcov.info');
const content = fs.readFileSync(lcovPath, 'utf8');

// 替换错误路径前缀，根据实际路径调整规则
const fixedContent = content.replace(/Content\/angular-project\/src\//g, './src/');

fs.writeFileSync(lcovPath, fixedContent, 'utf8');
console.log('LCOV路径已修正');

2. 在package.json的scripts中添加命令：

{
  "scripts": {
    "test:coverage": "jest --coverage && node fix-lcov-path.js"
  }
}

3. 执行npm run test:coverage即可自动完成覆盖率生成与路径修正。

方法4：升级Jest到最新稳定版

Jest 29.5可能存在路径解析的已知bug，升级到最新29.x版本（如29.7.0）可能修复问题：

npm install jest@latest --save-dev

升级后重新运行覆盖率测试，验证错误是否消失。

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