安装gatsby-source-strapi时出现Gatsby错误,求错误原因及解决办法
错误原因
你遇到的核心问题是gatsby-source-strapi版本与Gatsby 5.2.0不兼容。旧版gatsby-source-strapi(v4及以下)仅适配Gatsby 4及更早版本,而Gatsby 5升级了底层依赖(如Webpack 5、React 18),旧插件无法适配这些变更,导致安装时出现依赖冲突报错。
解决办法
- 安装适配Gatsby 5的插件版本:目前gatsby-source-strapi已推出支持Gatsby 5的v5版本,执行命令:
若正式版未完全稳定,可先安装beta版本:npm install gatsby-source-strapi@latestnpm install gatsby-source-strapi@beta - 清理依赖环境后重装:
- 删除项目根目录下的
node_modules文件夹和package-lock.json文件 - 清理npm缓存:
npm cache clean --force - 重新执行安装命令
- 删除项目根目录下的
- 确认Node.js版本合规:Gatsby 5要求Node.js 18.x或20.x LTS版本,避免使用16.x及以下、21.x及以上非稳定版本
- 匹配Strapi版本:gatsby-source-strapi v5仅支持Strapi v4.x,若你仍在使用Strapi v3,需二选一:
- 升级Strapi到v4.x版本
- 降级Gatsby到v4.x版本,并安装对应gatsby-source-strapi v4版本
内容的提问来源于stack exchange,提问作者Laxico
相关产品推荐
相关产品推荐

