Shopify app dev 隧道连接失败怎么排查

现象#

在 Oxygen 或 Hydrogen 相关开发中，应用开发隧道不稳定，预览网址无法访问，或回调失败。

本地能跑，共享预览链接同事打不开。

原因#

隧道进程退出；公司网络限制；环境变量中的隧道网址过期；防火墙拦截。

部署目标选错或构建失败却仍共用旧隧道。

解决步骤#

查看终端隧道是否仍在运行，按现行命令行文档重启开发会话。

确认预览网址与当前隧道输出一致，不使用过期链接。

换网络或关闭干扰代理后重试。

区分本地开发隧道问题与 Oxygen 部署问题，分别查构建日志。

不要把临时隧道网址写进生产配置。

保存失败时的命令、输出与时间，便于对照官方状态或支持。

验收#

预览链接可访问且反映最新本地改动；部署环境使用正确的生产网址。