Windows创建Strapi博客模板项目出现GraphQLObjectType "Query"错误

报错说明 #

运行npx create-strapi-app my-project并选择blog模板时触发的报错Error: Cannot use GraphQLObjectType "Query" from another module or realm，中文含义为：错误：无法调用来自其他模块或域的GraphQL对象类型「Query」，该报错由GraphQL依赖多版本冲突导致。

解决步骤 #

• 清除本地缓存避免残留的旧版本依赖干扰
  依次执行以下命令：

  npx clear-npx-cache
  npm cache clean --force
  

  若使用yarn作为包管理器，额外执行：
  yarn cache clean
• 优先使用指定稳定版创建项目
  直接执行绑定稳定版本号的创建命令，跳过可能存在兼容性问题的最新版：
  npx create-strapi-app@4.12.1 my-project --template blog
• 冲突未解决时走手动安装流程
  若上述操作仍触发报错，先创建空白Strapi项目再手动安装模板：
  1. 创建空白项目：npx create-strapi-app@4.12.1 my-project
  2. 进入项目目录：cd my-project
  3. 安装blog模板：npm install @strapi/template-blog@1.0.0
  4. 启动项目：npm run develop

排查项：若本地曾全局安装过graphql包，先执行npm uninstall -g graphql卸载全局依赖，避免版本冲突

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