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

Gatsby v4使用gatsby-source-contentful部署Netlify时报缓存文件不存在错误

问题排查与解决方案
  • 升级适配Gatsby v4的相关依赖
    你当前使用的gatsby-plugin-netlify@3.14.0仅适配Gatsby v3版本,和Gatsby v4的构建缓存逻辑不兼容,是触发该错误的常见原因。请将该依赖升级到^4.0.0及以上版本,同时升级gatsby-source-contentful到最新的6.x版本,6.0.0版本存在已知的Contentful媒体资源本地缓存路径生成bug,升级后可修复。
    可执行以下命令完成升级:
    npm install gatsby-plugin-netlify@latest gatsby-source-contentful@latest
    
    升级完成后删除本地的package-lock.json或yarn.lock文件,重新安装依赖后再推送代码,避免锁文件固定旧版本依赖导致部署时仍安装旧版本。
  • 修改Netlify构建命令
    不要仅依赖Netlify后台的清除缓存功能,直接在Netlify站点设置的构建命令处,将默认的gatsby build修改为gatsby clean && gatsby build,强制每次构建前清除所有本地缓存文件,避免残留旧的无效图片路径。
  • 检查Contentful资源与配置
    • 确认你项目中引用的所有Contentful图片均未在Contentful后台被删除,本地缓存的旧资源会导致本地构建正常,但部署时重新拉取资源会找不到对应文件
    • 如果你在gatsby-source-contentful配置中开启了downloadLocal: true,确认你使用的Contentful API密钥拥有媒体资源的访问权限,权限不足会导致图片下载失败,触发文件不存在错误。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.09.27 13:36:00