Vue项目使用Istanbul生成测试覆盖率时出现TypeError问题求助

问题详情 #

• 错误提示：TypeError: Cannot read properties of null (reading 'split')
• 涉及版本：@vitest/coverage-istanbul 的 0.34.1、0.34.6、1.0.1 版本
• 错误触发位置：removeQueryParameters 函数，路径为 node_modules/@vitest/coverage-istanbul/dist/provider.js:294:19
• 出错函数代码：

function removeQueryParameters(filename) {
  return filename.split("?")[0];
}

• 临时规避方案：在return语句前添加if判断，比如 if (!filename) return '';
• 当前环境依赖：

"nuxt": "^3.7.3",
"nuxt-vite": "^0.3.5",
"nuxt-vitest": "^0.10.5",
"@types/jest": "^29.5.4"

问题本质 #

这个错误是 @vitest/coverage-istanbul 的内部逻辑漏洞：removeQueryParameters 函数未对入参 filename 为 null/undefined 的情况做校验，直接调用 split 方法导致报错。你添加的if判断只是临时掩盖了报错，并未解决「为什么filename会变成null」的根源，但核心bug属于依赖包本身的问题，和你的项目配置无关。

可行解决方案 #

1. 升级到修复后的依赖版本 #

@vitest/coverage-istanbul 在 1.1.0 及后续版本 中已经修复了该问题，官方为函数添加了空值防御判断。直接升级依赖即可彻底解决：

npm install @vitest/coverage-istanbul@latest
# 或使用pnpm
pnpm add @vitest/coverage-istanbul@latest

2. 排查filename为空的触发场景 #

如果暂时无法升级，可以检查以下方向：

• 测试文件路径配置是否有误，导致vitest无法正确解析文件名
• 是否存在动态导入的组件/模块，在覆盖率统计时返回了空路径
• 核对 nuxt-vitest 配置中 test.coverage 的 include/exclude 规则，避免匹配到不存在的文件

3. 依赖补丁（临时方案，不推荐长期使用） #

若升级有阻碍，可使用 patch-package 给依赖打补丁：

1. 安装工具：npm install patch-package --save-dev
2. 修改 node_modules/@vitest/coverage-istanbul/dist/provider.js 中的函数：

function removeQueryParameters(filename) {
  return filename ? filename.split("?")[0] : '';
}

3. 生成补丁：npx patch-package @vitest/coverage-istanbul
4. 后续安装依赖时会自动应用该补丁

内容的提问来源于stack exchange，提问作者I try so hard but I cry harder