coverage-final.json多余data属性触发覆盖率对象缺失键报错如何修复

• 测试依赖版本/逻辑不统一：项目中存在多套覆盖率采集链路，比如部分文件用新版istanbul采集生成标准结构，另一部分文件用旧版自定义采集逻辑、或者混用v8 coverage转换脚本，输出时多套了一层data字段
• 覆盖率合并前置逻辑bug：如果在合并前有自定义的覆盖率预处理、上报逻辑，代码疏漏会导致标准覆盖率对象被额外嵌套进data属性再写入最终的json文件
• 多语言/多框架测试配置差异：从给出的示例可以看出.js文件的覆盖率都带data层、.tsx文件正常，大概率是js和ts的测试配置不统一，js对应的测试工具（比如低版本jest+旧版babel-plugin-istanbul）生成的结构不符合合并工具的要求

• 先排查近期测试相关改动：检查最近有没有升级nyc、jest、vite-plugin-istanbul等覆盖率相关依赖，有没有新增自定义的覆盖率转换/合并脚本
• 拆分采集链路验证：单独跑js文件的单测输出覆盖率文件、单独跑ts文件的单测输出覆盖率文件，确认哪类文件的采集链路生成了带data嵌套的异常结构
• 检查合并工具版本：确认当前用的覆盖率合并工具（比如nyc merge、istanbul-merge）的版本要求，是否不兼容带data嵌套的旧版结构

临时修复（快速解决合并阻塞） #

写个预处理脚本清洗coverage-final.json，剥掉多余的data嵌套层，参考代码：

const fs = require('fs');
const rawCoverage = require('./coverage-final.json');

const cleanedCoverage = Object.entries(rawCoverage).reduce((result, [filePath, coverageInfo]) => {
  // 存在data字段就直接取data内的结构，否则保留原结构
  result[filePath] = coverageInfo.data ?? coverageInfo;
  return result;
}, {});

fs.writeFileSync('./coverage-final-clean.json', JSON.stringify(cleanedCoverage, null, 2));

用清洗后的文件走后续合并流程即可。

永久修复 #

定位到生成异常结构的采集链路后针对性处理：

• 如果是旧版依赖导致的，将babel-plugin-istanbul、nyc等相关依赖升级到14.x以上的稳定版
• 如果是自定义转换逻辑加了data嵌套，直接去掉嵌套逻辑，保证所有覆盖率对象第一层就包含path、statementMap、s、fnMap等标准必填字段
• 如果是js和ts测试配置不一致，统一两类文件的覆盖率采集插件和版本，保证输出结构统一

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