如何解决BigCommerce Stencil CLI执行stencil start时的404错误

排查&修复步骤 #

• 检查API令牌权限与完整性
  首先确认你创建的Stencil API令牌已勾选主题管理、内容修改两个必要权限，同时确认复制令牌时没有遗漏字符：你示例中给出的令牌长度明显短于标准BigCommerce API令牌长度，大概率是复制时截断导致的，建议重新生成令牌并完整复制后再重试。
• 确认站点URL正确性
  使用https://store-xxxxxx.mybigcommerce.com/格式地址时，要确认xxxxxx部分和你后台显示的store hash完全一致，store hash可以在BigCommerce后台地址栏/admin/路径前的字段获取，不要手动输错字符。
• 清理旧配置重新初始化
  删除项目根目录下的.stencil隐藏配置文件，重新执行初始化命令：

  stencil init --url https://你的正确站点地址/ --token 完整的API令牌 --port 3000
  

• 排查网络拦截问题
  关闭本地代理、VPN软件，或切换网络环境后重试，部分企业防火墙、代理规则会拦截Stencil CLI向BigCommerce API发送的请求，导致404报错。
• 验证版本兼容性
  你当前使用的Stencil 3.2.1与Node 12.18.3属于兼容组合，无需降级版本，若以上步骤都无效可以尝试升级Stencil CLI到3.x最新稳定版：

  npm install -g @bigcommerce/stencil-cli@3
  

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