调用自定义useUser Hook时出现无法导入MapperKind编译错误求助

安全阿岳

2026-9-25

问题解答

MapperKind 含义

MapperKind 是 @graphql-tools/utils 包导出的枚举常量，用于标识 GraphQL Schema 中不同的可映射元素类型，包括对象类型、字段、参数、输入类型等，是 GraphQL Tools 生态中用于 Schema 处理、Mock 生成、结构转换等逻辑的标识类常量。

错误出现原因

该错误属于模块兼容性问题，触发原因主要有两类：

项目使用的打包工具（如webpack）对 .mjs 格式的ES模块处理规则存在缺陷，@graphql-tools/mock 依赖的 @graphql-tools/utils 将 MapperKind 作为命名导出暴露，但打包工具识别 .mjs 文件时将其错误判定为 CommonJS 模块，而 CommonJS 模块仅支持读取默认导出，找不到命名导出的 MapperKind 就会抛出该错误。
项目中安装的 @graphql-tools/mock 和 @graphql-tools/utils 版本不匹配，两者的导出规则不一致导致无法读取对应常量。

解决方案

首先对齐依赖版本：删除项目的 node_modules 文件夹和锁文件（package-lock.json / yarn.lock / pnpm-lock.yaml），重新执行依赖安装命令即可：

# npm 环境
npm install
# yarn 环境
yarn install
# pnpm 环境
pnpm install

如果你使用的是 create-react-app@4.x 等旧版本脚手架，打包工具默认对 .mjs 支持存在缺陷，若使用 react-app-rewired 自定义配置，可在 config-overrides.js 中添加如下规则：

module.exports = function override(config) {
  config.module.rules.push({
    test: /\.mjs$/,
    include: /node_modules/,
    type: "javascript/auto"
  });
  return config;
}