运行graphql-codegen报错：无法使用跨模块GraphQLInterfaceType‘AbstractEntity’

执行graphql-codegen --config codegen.yml时出现以下错误：

Error: Cannot use GraphQLInterfaceType "AbstractEntity" from another module or realm.

Ensure that there is only one instance of "graphql" in the node_modules directory. If different versions of "graphql" are the dependencies of other relied on modules, use "resolutions" to ensure only one version is installed.

Duplicate "graphql" modules cannot be used at the same time since different versions may have different capabilities and behavior. The data from one version used in the function from another could produce confusing and spurious results.

环境：Web和API服务器运行在Docker容器中，已确认无手动安装的其他GraphQL版本。

排查与解决步骤 #

• 检查容器内依赖树：进入Docker容器执行npm ls graphql或yarn list graphql，查看所有依赖项中GraphQL的版本，确认是否有间接依赖引入了不同版本。
• 清理Docker构建缓存：旧缓存可能导致容器内残留多版本依赖，执行docker build --no-cache .重新构建镜像，确保依赖安装环境干净。
• 强制统一GraphQL版本：
  • Yarn用户：在package.json中添加resolutions字段，强制所有依赖使用同一版本：

    "resolutions": {
      "graphql": "^16.8.0" // 替换为你项目实际使用的版本
    }
    

  • npm用户：在package.json中添加overrides字段：

    "overrides": {
      "graphql": "^16.8.0"
    }
    

• 排查Schema依赖：检查codegen.yml中引用的外部Schema文件或依赖包，确认这些资源是否自带GraphQL模块，导致版本冲突。
• 规范Dockerfile依赖安装：确保先复制package.json和锁文件（package-lock.json/yarn.lock）再执行安装命令，避免每次构建重新解析版本：

  COPY package*.json ./
  RUN npm install
  COPY . .
  

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