Shopify CLI 与 Headless

Oxygen 绑定自定义域名后一直 522 怎么排查

现象#

把 shop.example.com 指向 Oxygen 并在 DNS 加了 CNAME,访问返回 522,curl -I 也是 522;同一站点的 xxx.oxygen.shop 默认域名却完全正常。

原因#

  • 自定义域必须在 Hydrogen storefront 的 Domains 里添加并通过校验,只加解析不会建立路由
  • CNAME 目标写成了店铺域名,而不是控制台给出的 Oxygen 主机名
  • 根域用 A 记录指向旧服务器,与 CNAME 冲突,边缘拿不到源站
  • 证书仍在签发,522 期间边缘到源站的握手直接超时

处理步骤#

  1. 在 Hydrogen 后台 Domains 添加域名,原样复制它给出的 CNAME 目标,不要手写
  2. 用 dig +short shop.example.com CNAME 确认解析到 Oxygen 主机名
  3. 根域改用 ALIAS 或 301 到 www,避免 A 记录与 CNAME 同时存在
  4. 等证书状态变成 Active,期间用 curl -I https://shop.example.com 观察
  5. Cloudflare 侧先设 DNS only,验证通后再决定是否开代理

验收标准#

curl -I https://shop.example.com 返回 200,页面内容与默认 oxygen.shop 域名一致,证书状态为 Active。

本文由 风格技术 技术团队整理,适用于 Shopify 标准版与 Plus 店铺。Shopify 平台能力迭代较快,具体操作路径与字段以官方文档和店铺后台实际版本为准。