Gatsby本地及Netlify构建正常 部署Cloudflare Pages返回401错误

排查方案 #

• 优先确认环境变量配置有效性
  1. 核对Cloudflare Pages中添加的Storyblok令牌变量名，和gatsby-config.js中gatsby-source-storyblok插件配置读取的变量名完全一致，注意大小写、前后无多余空格
  2. 确认你部署的分支对应环境（生产/预览）都配置了对应变量，Cloudflare Pages的生产和预览环境变量是独立配置的
  3. 修改变量后必须触发全新构建（推送新代码/在控制台选择创建新部署），直接重试旧部署不会读取更新后的环境变量
• 确认Storyblok插件配置完整
  如果你创建的是Storyblok美国区空间，需要在插件配置中额外添加region: 'us'参数，不同区域的令牌不通用，本地/Netlify如果已经配置过该参数会正常运行，Cloudflare部署时如果配置遗漏会触发401
• 添加临时调试日志定位问题
  在gatsby-config.js读取Storyblok令牌的代码后添加console.log('STORYBLOK TOKEN:', process.env.你的令牌变量名)，触发构建后查看Cloudflare的构建日志，确认读取到的令牌值和你预期一致，排除特殊字符转义、变量截断的问题
• 排除令牌权限问题
  确认你使用的是Storyblok公共访问令牌（只读权限），而非预览令牌/编辑令牌，构建阶段不需要预览权限，错误的令牌类型也会触发401错误

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