求助：istanbul-middleware提示“No Coverage information has been collected”

我之前在做Babel项目集成istanbul-middleware时，也碰到过一模一样的“No Coverage information has been collected”问题，折腾了好一阵才解决，给你几个实用的排查方向：

1. 确认Babel与istanbul的兼容性配置 #

• 如果你用的是Babel 7及以上版本，必须安装babel-plugin-istanbul，并在Babel配置文件（.babelrc或babel.config.js）中仅在开发环境启用它——生产环境千万别开，会影响性能：

  {
    "env": {
      "development": {
        "plugins": ["istanbul"]
      }
    }
  }
  

• 检查你的Babel配置里有没有移除__coverage__变量的插件（比如某些压缩混淆插件），这类插件会直接破坏istanbul的覆盖率收集逻辑。

2. 保证hookLoader的执行时机绝对靠前 #

• im.hookLoader(__dirname)必须放在所有应用代码require之前，也就是server.js的最顶部！如果你的应用模块在hookLoader之前就被加载了，这些模块根本不会被istanbul hook，自然不会产生覆盖率数据。正确的顺序应该是：

  const im = require('istanbul-middleware');
  // 先执行hookLoader，这一步必须最先做
  im.hookLoader(__dirname);
  // 再加载其他依赖和应用代码
  const express = require('express');
  const app = require('./your-app-entry');
  

3. 验证路由配置与访问逻辑 #

• 确保覆盖率路由挂载正确，并且开启verbose模式方便排查：

  app.use('/coverage', im.createHandler({
    verbose: true, // 开启后控制台会输出详细日志
    resetOnGet: false
  }));
  

• 重要提醒：访问/coverage之前，必须先让应用处理过实际请求（比如调用几个接口、访问页面）！istanbul是基于代码执行来收集覆盖率的，没有被执行过的代码不会有任何数据记录。

4. 检查文件匹配规则 #

• 如果你的项目用了.jsx、.ts这类非标准.js扩展名，需要手动指定hook的文件扩展名：

  im.hookLoader(__dirname, {
    extensions: ['.js', '.jsx']
  });
  

• 确认没有误排除应用代码目录，默认node_modules会被排除，但如果你的业务代码在某个子目录被意外加入排除列表，也会导致无覆盖率数据。

5. 查看控制台日志定位问题 #

• 开启verbose选项后，访问/coverage时盯着Node.js控制台的输出，里面会显示哪些文件被处理、有没有加载失败或者覆盖率数据为空的原因，这是最快定位问题的方法。

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