Shopify 应用与扩展
Shopify 应用要在前台露出内容，只能走 Theme App Extension 这条通道，而 App Block 与 App Embed 的生效条件完全不同：前者依附模板类型，后者依附主题。本分类说明非 OS 2.0 主题看不到应用区块、嵌入开在未发布主题、脚本被广告拦截等场景的判断方法与补救方案。
-
01
改了 scopes 后店铺权限不更新怎么办
在 toml 里补了 write_discounts 并部署……
-
02
blocks 下 liquid 文件名会影响区块 handle 吗
把区块文件命名为 Product Reviews.liquid，部署后在主题编辑器里显示成一串带空格的名字……
-
03
应用区块最多只能拖一个是不是 max_blocks 限制
商家想把评分区块放到每个商品卡片里，编辑器里最多只能放 1 个，再拖第二个就提示该区块数量已达上限。
-
04
非 OS 2.0 主题找不到应用区块怎么办
非 OS 2.0 主题没有应用区块挂载点，编辑器不会出现该应用区块。
-
05
Shopify 应用区块只支持商品模板怎么办
应用区块 schema 的目标模板若只写 product，则无法在集合或首页添加。
-
06
app block 的 target 写成 body 为什么不显示
在 app block 的 schema 写了 "target": "body"……
-
07
Shopify App Bridge 脚本加载失败导致页面空白
应用页面在本地正常，部署到线上后白屏，控制台提示 app-bridge.js 加载失败或 shopify 未定义。
-
08
两个功能重叠的应用互相覆盖怎么定位
装了新的折扣应用后，原来的捆绑销售失效；或两个应用都在改购物车，价格显示来回跳。
-
09
shopify app deploy 成功但扩展还是旧的
shopify app deploy 输出成功，Dev Dashboard 里新版本也变成 Active……
-
10
Shopify 应用重复订阅 webhook 导致事件处理多次
同一订单创建事件被处理两三遍，日志里同一个 X-Shopify-Event-Id 出现多次。
-
11
Shopify App Embed 被广告拦截怎么办
广告拦截与隐私扩展可能拦截 App Embed 注入的脚本域名，表现为功能键失灵。
-
12
App Embed 开在未发布主题上怎么恢复
应用嵌入常默认打在当前预览主题，若未发布主题被选中，线上当然看不到。
-
13
Shopify 应用嵌入在结账页不生效怎么办
应用在商品页正常显示，到结账页就消失；商家以为是应用坏了，实际是结账页不再支持 app embed。
-
14
Shopify 嵌入式应用 iframe 高度不自适应怎么修
应用页面内容比 iframe 高，出现双层滚动条；或者内容很短但 iframe 留出大片空白。
-
15
Shopify 应用安装时 OAuth 反复跳转怎么排查
点安装后在授权页与回调地址之间来回跳，最终报重定向次数过多，应用装不上。
-
16
应用写入的 metafield 前台读出来是空的
应用用 metafieldsSet 写了 $app 命名空间的保修信息，后台商品页能看到值……
-
17
Shopify App Proxy 返回 404 怎么排查
前端请求 /apps/myapp/api 返回 404 或 502，直接访问应用服务器地址却正常。
-
18
Shopify 应用调用 API 被限流怎么设计重试
批量同步时大量请求返回 429，日志里一片 Throttled，同步任务跑不完。
-
19
App Store 审核说结账流程不合规怎么改
审核邮件指出结账流程不合规：应用在结账页插了自定义脚本，或要求商家先注册站外账号才能使用，提审被退回。
-
20
多个应用脚本加载顺序冲突导致功能异常
单独装某个应用正常，和另一个应用一起装就报 $ is not defined 或购物车更新失效。
-
21
Shopify 嵌入式应用 session token 过期怎么处理
应用在后台 iframe 里用一会儿就报 401，刷新后又正常，客服反馈「老是掉线」。
-
22
Shopify 应用商店审核被拒：权限范围过大怎么改
提审后收到拒信，指出申请的 access scope 与实际功能不符，要求最小化权限。
-
23
App Store 截图尺寸不对一直传不上去
上传列表截图时提示尺寸不符，或审核反馈截图里带浏览器窗口和测试数据，要求重传全部图片。
-
24
Shopify 应用订阅计费回调没收到怎么处理
商家完成了应用付费确认，但应用侧仍是免费版，数据库里没有订阅记录。
-
25
订阅接口返回 userErrors 为空怎么定位
调用 appSubscriptionCreate 返回 200，但 appSubscription 是 null……
-
26
shopify.app.toml 改完不生效是哪些字段没部署
在本地改了 shopify.app.toml 的 application_url 和 scopes……
-
27
Shopify 应用卸载后数据没清理怎么设计
商家卸载应用后重新安装，看到的是几个月前的旧数据与旧配置，甚至仍收到已停用的通知。
-
28
没接 app/uninstalled 导致 token 一直 401
商家卸载应用后，后台任务仍在用旧 token 调 Admin API……
-
29
计费 test 参数忘了关导致商家没被扣款
开发店测订阅一切正常，上线后商家装完应用却在 Settings → Billing 的 App charges 里看……
-
30
Shopify 嵌入式应用被 CSP 拦截怎么处理
应用在 Shopify 后台以 iframe 打开后白屏……
-
31
扩展版本一直是未发布状态该怎么上线呢
Dev Dashboard 的 Versions 页里最新版本状态是 Draft，CLI 明明提示部署成功……
-
32
extensions 目录里的扩展 CLI 识别不到
extensions/ 下明明有 theme 扩展目录……
-
33
三个 GDPR webhook 没实现会被拒绝上架吗
提审时 App Store review 页面提示缺少 mandatory compliance webhooks……
-
34
自建 iframe 里为什么用不了 App Bridge
在自己的 iframe 里嵌入应用页面，window.shopify 是 undefined……
-
35
redirect_uri 不在白名单导致 OAuth 失败
点安装后跳到 Shopify 授权页，随后整页显示 OAuth error invalid_request: The……
-
36
ScriptTag 注入的脚本被 CSP 拦截怎么放行
前台控制台出现 Refused to load the script because it violates the……
-
37
应用脚本和主题 defer 顺序冲突报未定义
应用注入的脚本比主题脚本先执行，控制台报 Uncaught ReferenceError: Shopify is n……
-
38
应用订阅升级后补差金额为什么不是差价
商家从 10 美元套餐升到 30 美元，当天账单只补了十几美元，财务按差价 20 美元对账，怎么也对不上。
-
39
Theme App Extension 部署成功但区块列表没有怎么办
应用已部署，shopify app deploy 也成功，但在主题编辑器的「应用区块」里找不到自己的 block……
-
40
卸载应用后主题残留应用区块导致报错怎么办
卸载某个应用后，前台对应位置空白，编辑器里显示「此区块来自已卸载的应用」，有时整页渲染中断。
