You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

如何在Gatsby Cloud中安装插件?本地正常云端构建报错如何解决

问题解决方案

本地运行正常但Gatsby Cloud部署报插件缺失错误,可按以下步骤排查解决:

  • 首先检查项目根目录package.json的dependencies字段,确认gatsby-plugin-image、gatsby-plugin-sharp、gatsby-transformer-sharp等插件是否列在生产依赖中。如果插件被误放在devDependencies里,要么将其移动到dependencies,要么在Gatsby Cloud的构建设置中开启安装开发依赖的选项(不推荐该方式,Gatsby官方要求站点运行必需的插件都需放在生产依赖中)。
  • 确认依赖锁定文件已提交到代码仓库:本地安装依赖后生成的package-lock.json(npm)、yarn.lock(Yarn)或pnpm-lock.yaml(pnpm)必须随代码一起提交,Gatsby Cloud会根据锁定文件安装完全一致的依赖版本,避免因依赖不一致导致的漏装问题。
  • 清理构建缓存后重新构建:登录Gatsby Cloud控制台,进入对应项目的构建页面,选择「Clear cache and rebuild」选项,强制清空旧缓存、重新拉取所有依赖后构建,排除旧缓存干扰。
  • 检查项目根目录的.gitignore文件,确认没有误屏蔽依赖锁定文件,如果文件中包含package-lock.json、yarn.lock等规则,删除对应规则后重新提交锁定文件。
  • 可选校验:如果上述步骤都无效,可在项目根目录添加.nvmrc文件,写入本地正常运行的Node.js版本号,确保Gatsby Cloud使用和本地一致的Node环境构建。

内容的提问来源于stack exchange,提问作者Gretski

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.06 05:30:04