Shopify 应用与扩展

shopify.app.toml 改完不生效是哪些字段没部署

现象#

在本地改了 shopify.app.toml 的 application_url 和 scopes,shopify app dev 在开发店正常,但已安装的正式店打开应用仍跳旧域名,Dev Dashboard 的 Versions 页也没有新记录。

原因#

  • toml 的改动只在 dev 店铺自动生效,正式店铺必须 deploy 发布新的 app version
  • 仓库里有多份 shopify.app.*.toml,命令没加 --config,CLI 读的是默认那份
  • application_url 必须与 OAuth 回调同源,写成相对路径或漏掉 https 会被服务端拒绝
  • Dev Dashboard 里手改过 URL,下一次 deploy 会整体覆盖,页面显示的可能不是本地那份

处理步骤#

  1. 在项目根目录执行 shopify app config link,确认绑定的是目标应用与配置文件
  2. 打开 toml 核对 application_url 与 scopes 两项
  3. 执行 shopify app deploy,确认输出里出现 Released app version
  4. 到 Dev Dashboard 的 Versions 页,确认新版本状态为 Active
  5. 从后台侧栏重新打开应用,看地址栏域名是否已换成新值

验收标准#

Versions 页的 Active 版本包含本次改动,应用从后台打开时地址栏域名与 application_url 完全一致。

本文由 风格技术 技术团队整理,适用于 Shopify 标准版与 Plus 店铺。Shopify 平台能力迭代较快,具体操作路径与字段以官方文档和店铺后台实际版本为准。