React新手升级Gatsby到3.0及相关依赖遇npm依赖冲突如何解决
报错核心原因
- Gatsby生态的插件和主版本号是强绑定的,跨大版本升级时旧插件不认新主版本、新插件不认旧主版本,你当前项目里同时存在要求Gatsby v2的旧插件、要求Gatsby v3的新插件,双向版本校验不通过才触发了ERESOLVE报错
- 之前用
npm install --force gatsby@3.0.0、npm update没生效,本质是只单独升级了gatsby主包,没有同步对齐所有关联插件的适配版本,依赖校验逻辑直接拦截了不完整的升级操作
正确升级步骤
- 清除本地旧依赖和锁文件,消除旧版本残留的版本索引,执行命令:
rm -rf node_modules package-lock.json - 打开项目根目录的
package.json,把所有关联依赖的版本手动调整到Gatsby v3的适配线,对照你之前npm outdated的查询结果对齐版本:- 主包
gatsby设置为^3.0.0 - 插件
gatsby-plugin-sass设置为^4.0.0 - 插件
gatsby-source-filesystem设置为^3.0.0 - 插件
gatsby-transformer-remark设置为^3.0.0 - 核心依赖
react、react-dom设置为^17.0.1
额外注意:要把package.json里所有带gatsby-前缀的插件(比如报错里提到的gatsby-plugin-sharp、gatsby-plugin-image、gatsby-source-contentful)都同步升级到要求Gatsby v3的对应大版本,不要残留v2.x线的旧插件版本,这是之前报错的核心冲突源
- 主包
- 安装依赖时不要用--force强制破坏npm保护机制,用npm官方提示的兼容参数跳过临时的peer依赖校验,执行命令:
npm install --legacy-peer-deps - 等安装完成后,启动开发服务验证运行状态,执行命令:
npm run develop
避坑提醒:Gatsby v2升级到v3属于破坏性大版本更新,装完依赖如果启动报API废弃错误,需要同步调整gatsby-config.js、gatsby-node.js里被移除的旧API写法,不能只靠改依赖版本完成全量升级。
内容的提问来源于stack exchange,提问作者Neto Sena
相关产品推荐
相关产品推荐

