Jest + Nock 如何配置使得发起未模拟请求时测试直接失败

问题原因 #

你遇到的现象本质是Nock抛出的NetConnectNotAllowedError被JSDOM内部捕获，仅输出到错误日志而没有冒泡到Jest的测试执行上下文，同时测试用例在异步请求回调触发前就已经完成断言并标记为通过，所以最终测试结果显示成功但存在报错日志。

解决方案 #

以下三种方案可独立使用也可组合使用，按需选择即可：

方案1：全局配置Nock未匹配请求直接抛错 #

在Jest全局初始化文件（通常为jest.setup.js）中添加如下配置，让Nock遇到未模拟的请求时直接抛出可被Jest捕获的错误：

const nock = require('nock');

// 禁用所有未被模拟的网络请求，你大概率已经配置了该字段
nock.disableNetConnect();

// 配置未匹配请求的回调，直接抛出错误
nock.setOnNoMatch((_, requestOptions) => {
  throw new Error(`检测到未模拟的网络请求: ${requestOptions.method} ${requestOptions.href}`);
});

方案2：每个测试结束后校验Nock执行状态 #

在同一个Jest全局初始化文件中添加afterEach钩子，校验所有定义的Nock模拟都被调用，同时清理残余模拟避免用例间互相影响：

afterEach(() => {
  // 存在未被调用的Nock模拟时直接让测试失败
  if (!nock.isDone()) {
    throw new Error(`存在未调用的接口模拟：${JSON.stringify(nock.pendingMocks())}`);
  }
  // 清理当前用例的所有Nock模拟
  nock.cleanAll();
});

方案3：劫持console.error捕获Nock报错 #

如果上述方案未生效（报错仍仅输出到日志），可以劫持全局console.error方法，检测到Nock相关错误时直接抛出：

const originalConsoleError = console.error;
console.error = (...args) => {
  const errorContent = args.join(' ');
  if (errorContent.includes('NetConnectNotAllowedError') || errorContent.includes('Nock: Disallowed net connect')) {
    throw new Error(`检测到未模拟的Nock请求: ${errorContent}`);
  }
  originalConsoleError.apply(console, args);
};

注意事项 #

请确保所有测试用例都等待异步操作完成后再结束，比如使用React Testing Library的findBy*异步查询器，或者用waitFor包裹断言逻辑，避免异步请求的错误在测试标记为通过后才抛出。

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