订阅应用在顾客账户页失效报 404 怎么办

现象#

顾客在账户页点「Manage subscription」，跳到订阅应用的旧页面后返回 404，或者账户页里原本存在的订阅 tab 直接消失。

原因#

• 应用把入口注入在 customers/account.liquid，升级新账户后该模板不再渲染
• 应用已提供 customer account UI extension，但商家没在账户编辑器里加 block
• 扩展声明的 target 与页面不匹配，订阅管理挂在 order status 上却在 Profile 里找
• 应用版本太旧，安装时只注册了 legacy 的 App Proxy 路由

处理步骤#

1. 在账户编辑器的 Profile 与 Order status 页分别点 Add block，看列表里有没有该应用的区块
2. 把应用升到最新版，并在 shopify.app.toml 里确认已声明 customer account 相关扩展
3. 确认 shopify.extension.toml 的 target 是 customer-account.profile.block.render
4. 用 shopify app dev 预览，点按钮看是否跳到应用自己的 customer portal
5. 过渡期先在账户页放一个指向应用独立 portal 的链接，把可用性保住

验收标准#

测试顾客在 /account 点「Manage subscription」能打开订阅列表，并成功跳过一期账单。