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 会整体覆盖,页面显示的可能不是本地那份
处理步骤#
- 在项目根目录执行
shopify app config link,确认绑定的是目标应用与配置文件 - 打开 toml 核对
application_url与scopes两项 - 执行
shopify app deploy,确认输出里出现 Released app version - 到 Dev Dashboard 的 Versions 页,确认新版本状态为 Active
- 从后台侧栏重新打开应用,看地址栏域名是否已换成新值
验收标准#
Versions 页的 Active 版本包含本次改动,应用从后台打开时地址栏域名与 application_url 完全一致。
本文由 风格技术 技术团队整理,适用于 Shopify 标准版与 Plus 店铺。Shopify 平台能力迭代较快,具体操作路径与字段以官方文档和店铺后台实际版本为准。