Shopify theme dev 连不上店铺怎么排查

现象#

本地主题开发命令连不上店铺，或无头项目因店面接口令牌无效而拉不到目录数据。

报授权失败或资源不可用。

原因#

令牌过期或权限不足；店铺与令牌不匹配；本地环境变量指错店铺。

主题开发会话未建立；防火墙拦截本地回环或隧道。

解决步骤#

确认环境变量中的店铺域名与令牌属于同一店铺。

按开发者文档重新创建具有所需范围的店面接口令牌或应用授权。

重新运行主题开发或链接命令，确保会话建立。

检查本地网络与防火墙是否干扰隧道。

不要把令牌提交到公开仓库；泄露则立刻轮换。

用最小查询验证令牌可读商品列表后再启动完整应用。

验收#

本地可拉取商品或主题预览成功，授权错误消失。