Hydrogen 与 Oxygen 是 Shopify Headless 方案的一部分，不是自动“毫秒级”或“超高性能”的保证。Hydrogen 负责 React 店面开发，Oxygen 是 Shopify 提供的托管运行环境；最终速度仍取决于数据查询、缓存、图片、第三方脚本、网络、代码和页面任务。选择 Headless 前先证明普通主题无法满足的需求。
适用性与架构
列出内容管理、商品、搜索、购物车、账户、市场、结账、ERP 和分析需求。明确 Storefront API、Hydrogen、Oxygen、CMS、支付和后台系统的责任。Headless 会增加部署、监控、缓存、预览、SEO 和团队技能要求，不应只用“更快”作为决策理由。
| 层 | 负责什么 | 验收 |
|---|---|---|
| 前端 | 页面、交互、可访问性 | 设备与任务测试 |
| 数据 | 商品、库存、市场 | API 错误与缓存 |
| 运行 | 构建、日志、回滚 | 发布演练 |
| 搜索 | URL、元数据、结构化数据 | 抓取与索引检查 |
性能与缓存验收
固定页面、设备和网络，比较 SSR/缓存命中、LCP、INP、CLS、错误率和真实用户数据。为商品、集合、库存和市场信息设置合理缓存失效策略；不能把过期库存或价格缓存给客户。第三方脚本和图片优化往往比框架名称更影响结果。
发布与故障恢复
记录环境变量、Storefront API 权限、构建版本、依赖、预览和回滚点。测试 API 限流、超时、无库存、价格变化、结账失败和 Oxygen 部署失败。出现严重问题时先切回稳定版本，再分析日志。
全球化、SEO 与 GEO
Headless 需要自己负责 canonical、hreflang、sitemap、robots、结构化数据、状态页和错误页。多市场 URL、币种、税费、库存和政策必须来自一致的事实源。AI 摘要依赖可抓取 HTML、清晰实体、FAQ、来源和更新时间；框架本身不能保证收录。
何时不应选 Headless
如果团队没有 React/GraphQL/部署能力，需求可由主题和应用满足，Headless 可能增加维护风险。先做小范围原型和成本模型，不要把企业级技术栈当成品牌规模的证明。
FAQ
Hydrogen 一定比 Shopify 主题快吗？
不一定。数据、缓存、脚本、图片、网络和实现质量都会影响性能。
Oxygen 是 CDN 吗？
它是 Shopify 的托管运行环境，不应把它简单等同于所有 CDN 或性能保证。
Headless 会自动提高 SEO 吗？
不会。URL、HTML、元数据、结构化数据、链接和可访问性仍需自行验收。
如何让 Headless 页面支持 GEO？
输出稳定 HTML、商品事实、FAQ、来源、更新时间和明确市场信息，并检查爬虫看到的内容。