Shopify 应用开发

要解决什么问题

在 Shopify 上开发应用时，常见踩坑包括：管理后台嵌入与 App Bridge 版本不一致、Webhook 未先返回 200 导致重试风暴、仍用已弃用的 REST Admin API 做新功能，以及 GDPR 与客户敏感数据访问未按平台要求实现。本技能把官方推荐路径与团队实践收敛成可检索的决策清单。

技能如何组织内容

技能按三类模式展开：

• React Router 应用设置：以现代 Shopify 应用模板（React Router）作为新项目的默认骨架。
• 带 App Bridge 的嵌入应用：在 Shopify Admin 内嵌渲染 UI，并强调通过脚本标签使用最新 App Bridge。
• Webhook 处理：基于 HMAC 校验请求来源，并遵循「先响应、后异步处理」的交付顺序。

同时列出反模式（例如新应用继续走 REST、先处理 Webhook 再响应、用轮询替代 Webhook），并在「锐利边缘」中按严重程度标注：速率限制响应头、受保护客户数据、仅使用 TOML 配置（推荐）、兼容两种 URL 格式、新代码统一 GraphQL、完整 GDPR 处理程序等。

适用边界与注意点

本技能是架构与合规向的速查，不替代 Shopify 官方文档 的 API 细节。若你维护的是历史 REST 集成，迁移到 GraphQL 需要单独排期；Webhook 与后台任务的幂等与重试策略仍需结合自己的队列与监控实现。