Jest无法兼容nanoid 4.x？报"SyntaxError: Cannot use import..."错误

DevOps 小满

2026-8-20

问题背景

在monorepo的某个包中引入nanoid@4.0.0后，下游包的Jest测试出现以下报错：

Details:

/Users/mikehogan/repos/personal/docsndata-monorepo/node_modules/.pnpm/nanoid@4.0.0/node_modules/nanoid/index.js:1
({"Object.<anonymous>":function(module,exports,require,__dirname,__filename,jest){import { randomFillSync } from 'crypto'
                                                                                  ^^^^^^

SyntaxError: Cannot use import statement outside a module

   9 | const model_types_2 = require("@docsndata/model-types");
  10 | const model_types_3 = require("@docsndata/model-types");
> 11 | const nanoid_1 = require("nanoid");
     |                  ^
  12 | const uuid_1 = require("uuid");
  13 | function emptyStringMatchesRegexCondition() {
  14 |     return { _type: 'string.matches.regex', regex: "" };

at Runtime.createScriptFromCode (../../node_modules/.pnpm/jest-runtime@28.1.3/node_modules/jest-runtime/build/index.js:1796:14)
at Object.<anonymous> (../../model/core2/dist/cjs/property_types.js:11:18)

尝试添加crypto全局对象配置时，IDE提示需安装已废弃的crypto包且global未定义；使用Node.js 16 + TypeScript，调整过tsconfig.json与jest.config.js、修改crypto导入方式后仍报错。目前降级到nanoid@3.3.4可暂时解决，但需要根本修复方案。

疑问解答

1. 为什么Jest会受生产代码导入内容的影响？

Jest运行测试时，必须先加载并执行你的生产代码及所有依赖包——它不是孤立运行测试逻辑，而是在真实的代码环境中执行测试用例。当你的生产代码用CommonJS的require()引入了仅提供ES模块格式的nanoid@4.0.0时，Jest默认的CommonJS运行时无法识别ES模块的import语法，直接抛出语法错误。

2. 这是crypto包的特定问题，还是更普遍的模块兼容问题？

这是更普遍的ES模块与CommonJS兼容问题，和crypto本身无关。报错的核心是nanoid@4.0.0完全移除了CommonJS输出，只保留ES模块版本，但你的生产代码（或打包产物）用require()去引入它，而Jest默认运行时还在处理CommonJS模块，无法解析ES模块语法。报错信息里的import { randomFillSync } from 'crypto'是nanoid自身的ES模块代码，不是crypto包的问题。

3. 如何在拥有数千个Jest测试的大型monorepo中集中修复该问题？

针对monorepo场景，推荐以下集中修复方案，避免逐个包调整：

方案一：全局配置Jest支持ES模块

在monorepo根目录的jest.config.js中统一配置，让Jest能处理ES模块依赖：

module.exports = {
  projects: ['<rootDir>/packages/*'], // 适配monorepo多包结构
  testEnvironment: 'node',
  transform: {
    '^.+\\.tsx?$': ['ts-jest', { useESM: true }], // 开启ts-jest的ES模块支持
  },
  extensionsToTreatAsEsm: ['.ts', '.tsx'],
  transformIgnorePatterns: [
    'node_modules/(?!nanoid/)', // 不对nanoid忽略转译，让Jest处理它的ES模块
  ],
  globals: {
    'ts-jest': {
      useESM: true,
    },
  },
};

若部分包本身是ES模块，可在对应包的package.json中单独添加"type": "module"。

方案二：使用nanoid的CommonJS兼容入口

nanoid@4.x提供了专门的CommonJS入口，直接修改代码中的导入路径即可：

// 替换原 require('nanoid')
const { nanoid } = require('nanoid/cjs');

TypeScript代码调整为：

import { nanoid } from 'nanoid/cjs';

可通过ESLint规则或批量替换工具，在monorepo中统一修改所有nanoid的导入路径，无需改动Jest配置。

方案三：升级Jest到ES模块支持更完善的版本

Jest 29对ES模块的支持更成熟，若monorepo可升级到Jest 29.x，能大幅减少配置成本。升级后配合testEnvironment: 'node'和extensionsToTreatAsEsm配置，即可顺畅处理ES模块依赖。

方案四：用Babel转译ES模块依赖

若不想启用Jest的ES模块模式，可通过Babel将nanoid转译为CommonJS。根目录babel.config.js配置：

module.exports = {
  presets: [['@babel/preset-env', { targets: { node: '16' } }], '@babel/preset-typescript'],
  ignore: ['node_modules/(?!nanoid/)'], // 仅转译nanoid
};

Jest配置中指定用babel-jest转译：

module.exports = {
  transform: {
    '^.+\\.(ts|tsx)$': 'babel-jest',
  },
  transformIgnorePatterns: ['node_modules/(?!nanoid/)'],
};

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