Create React App项目Jest单测报export const导出函数非函数错误

所有export const导出的函数被Jest识别为非函数，本质是模块转译规则不匹配、模块加载时序错误两类问题导致，和函数本身的实现逻辑无关。从报错堆栈里的(0 , _Utils.generateUUID) is not a function可以看到，Babel已经识别到了Utils模块的引入，但是导出的绑定值是undefined，即没有把导出的函数正确挂载到模块导出对象上

常见排查与修复点 #

• 检查Babel配置是否覆盖了CRA默认的模块转译规则
  打开根目录下的.babelrc或babel.config.js，如果存在手动配置的@babel/preset-env，确认modules参数值：

// 错误配置示例：会让Babel输出ES模块，Jest无法正确解析
{
  "presets": [
    ["@babel/preset-env", { "modules": "esm" }]
  ]
}

修复方式：直接删除自定义的Babel preset配置，改用CRA内置的react-app预设作为基础，保证模块转译输出符合Jest的CommonJS解析要求：

// 正确的Babel配置示例
module.exports = {
  presets: ['react-app']
};

• 检查Babel插件加载顺序
  如果项目手动引入了导出语法相关的Babel插件（比如@babel/plugin-proposal-export-default-from），需要确保模块转译插件放在所有导出类插件的最后，避免转译时把export const语法错误解析成未赋值的导出占位符。
• 检查Jest的转译排除规则
  核对package.json中的Jest配置，确认transformIgnorePatterns没有把src目录纳入排除范围，默认CRA的配置仅排除node_modules下的代码，如果被修改为排除src路径，会导致本地ES模块代码未经过Babel转译就被Jest直接加载，触发导出值识别错误。
• 排查循环依赖问题
  从当前报错堆栈可以看到模块加载链路为：Commons.js → VehicleStore.js → GenericClass.js → App.js → index.js。如果Utils.js内部存在反向导入Commons.js的逻辑，就会形成循环依赖，模块初始化时generateUUID还没被挂载到导出对象上就被提前调用，触发“非函数”报错。
  排查方式：把触发报错的generateUUID()方法直接在当前文件内实现一份，或者把涉及循环引用的公共工具方法拆到独立的、没有反向依赖的工具文件中，打断循环加载链路。

快速验证方法 #

在项目根目录新建临时测试文件check-export.spec.js，写入以下内容：

import { generateUUID } from './src/utils/Utils';
test('验证导出的UUID方法可正常调用', () => {
  expect(typeof generateUUID).toBe('function');
});

运行yarn test check-export.spec.js：

• 如果测试直接报类型错误，说明是Babel转译配置问题，按前面的Babel配置修复项调整即可
• 如果测试通过但业务测试仍报错，说明是循环依赖导致的加载时序问题

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