创建Shopify应用时Cloudflare隧道启动失败的排查与解决

针对你遇到的Could not start Cloudflare tunnel: Failed to create new quic connection error="failed to dial to edge with quic: timeout: no recent network activity"错误，可按以下步骤排查修复：

• 检查网络环境

  • 切换至稳定的网络（比如有线网络），避免使用不稳定的公共Wi-Fi
  • 暂时关闭本地防火墙、杀毒软件的网络拦截模块，确认是否是这类工具阻断了QUIC协议（UDP 7844端口）的连接

• 重置Shopify CLI隧道配置

  • 执行shopify app dev --reset命令，重置本地的Cloudflare隧道相关配置
  • 若无效，删除项目根目录下的.shopify文件夹（注意备份必要配置），再重新运行shopify app dev

• 强制使用TCP协议替代QUIC

  • 启动dev命令时添加环境变量强制使用TCP：CF_TUNNEL_PROTOCOL=tcp shopify app dev
  • 也可在本地环境变量中设置CF_TUNNEL_PROTOCOL=tcp，之后再执行dev命令

• 更新Shopify CLI到最新版本

  • 使用npm更新：npm update -g @shopify/cli
  • 使用Homebrew更新：brew upgrade shopify-cli
    新版本CLI可能修复了Cloudflare隧道连接的已知bug

内容的提问来源于stack exchange，提问作者Nawar