Jest spyOn无法捕获已执行的createProduct调用，测试计数为0

问题诱因 #

• 异步操作未被完整await（最高概率诱因）
  报错仅出现在createProductSpy的断言行，说明前置的getItemSkusWithWebContent、getAllProducts的调用已经被正确等待，完全匹配以下场景：业务函数getNewProductsAndUploadToWoo内部使用forEach/map等同步迭代方法遍历SKU列表，迭代回调内的全链路异步操作（从getItemLocationDetail到createProduct的调用）未被外层显式await。
  这会导致测试中的await cronHelper.getNewProductsAndUploadToWoo()只会等待函数开头的同步await逻辑完成，就提前返回。此时迭代内的createProduct还在异步执行队列中，尚未被调用，测试执行断言时自然捕获不到调用记录。等测试断言完成、进程退出前，这些异步操作才陆续执行完毕，因此控制台才会出现函数执行的日志。
• 模块引用不匹配（次要可能）
  如果业务代码没有直接通过wooFunctions.createProduct调用方法，而是在模块顶部将createProduct从wooFunctions中解构后直接调用：

  // 业务代码顶部的解构导入
  const { createProduct } = require('./wooFunctions');
  // 后续直接调用，而非通过wooFunctions对象调用
  

  此时jest.spyOn(wooFunctions, 'createProduct')只会修改wooFunctions对象的createProduct属性引用，不会影响业务代码中已经完成解构的createProduct变量，因此Spy捕获不到调用。该情况会导致所有wooFunctions的Spy失效，与「其他函数正常返回Spy数据、仅createProduct计数为0」的现象匹配度较低。

解决方案 #

• 针对异步未await的核心场景：
  改造业务代码的迭代逻辑，将forEach替换为for...of循环并显式阻塞等待单SKU处理流程完成：

  // 业务代码改造示例
  for (const sku of skuList) {
    // 原有单SKU处理的全量异步逻辑
    const [itemLocationDetail, itemMaster, itemWebContent] = await Promise.all([
      getItemLocationDetailPromise,
      getItemMasterPromise,
      getItemWebContentBySkuPromise
    ]);
    // 构建product、调用createProduct的逻辑
    await wooFunctions.createProduct(product);
  }
  

  如果需要并行处理多个SKU，需显式等待所有处理Promise完成：

  const skuProcessingPromises = skuList.map(async (sku) => {
    // 原有单SKU处理逻辑
  });
  await Promise.all(skuProcessingPromises);
  

  改造后，测试中的await cronHelper.getNewProductsAndUploadToWoo()会等待所有SKU处理（包括createProduct调用）完成后才执行断言。
• 针对模块引用不匹配的场景：
  禁止在业务代码中解构导入的模块方法，始终通过模块对象调用方法；或测试时使用jest.mock批量mock整个模块的所有导出方法，替换原生模块引用。

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