Shopify 报错修复与故障排查
大多数「网站坏了」不是 Shopify 挂了，而是主题脚本、第三方应用、DNS/CDN、支付通道这四层里有一层出问题。我们按层定位，先恢复再找根因。
前台故障
白屏、样式错乱、按钮无反应、加购 422、购物车不更新、移动端错位。
支付与结账
支付方式不显示、3DS 反复验证、结账扩展报错、订单状态卡住。
安全与异常
主题被注入脚本、后台多出陌生管理员、试卡攻击、店铺被暂停后的整改。
响应与排期
工作时间 10 分钟响应初判；故障类工单优先于新需求排期。
常见的四类故障
- 主题层：刚改过代码或升级过主题，页面白屏、样式丢失、JS 报错阻断加购按钮
- 应用层：装/卸应用后残留脚本、脚本冲突、应用 block 不显示或样式打架
- 网络层：DNS 改动未生效、CDN 代理导致 522/525、SSL 证书未签发、AAAA 记录导致间歇性打不开
- 支付层：支付方式被风控隐藏、3DS 挑战失败、结账扩展请求后端超时
处理顺序：先恢复，再溯源
大促或投放期间的故障，第一动作永远不是「读代码找原因」，而是「回到上一个正常状态」。
- 用后台的主题发布历史回滚到上一个版本（刚更新过主题的故障，回滚前不做任何排查）
- 回滚无效时按浏览器控制台报错定位到具体脚本，临时禁用可疑应用或自定义 JS
- 支付类故障启用备用通道，同时联系收单方确认是否为通道侧问题
- 恢复之后再复现、定位根因，输出一份「为什么发生 + 怎么避免」的复盘
找外部支援时准备三样东西：后台权限、完整复现步骤（含设备与浏览器）、最近的改动清单。有这三样，定位时间通常能从半天缩到一小时。
被挂马与店铺暂停
页面被插入赌博/广告脚本、搜索结果出现大量陌生页面，属于安全事件：要同时清前端脚本、清后门文件、改密码、开两步验证、撤销所有自定义应用 token。只清前端不做权限审计，过两周会再来一遍。
店铺被暂停（Store suspended）多数是政策违规的自动化判定。处理方式是按违规类型整改 + 一次性提交完整材料申诉，申诉流程与材料清单 有详细步骤。
我们不做的事
- 不改平台底层、不承诺「保证解封」——申诉结果由平台判定
- 不做「破解主题」「共享应用账号」这类会连带处罚的操作
- 不在没有备份的情况下直接覆盖线上主题
