Shopify 报错排障

商品导入报 Failed to fetch 怎么解决

现象#

在商品页点导入上传 CSV,进度条走完后弹出 Failed to fetch,页面不给行号,导入记录里也找不到这次任务。

原因#

  • 文件超过 15 MB 或行数过多,上传请求在网关层被截断,前端只拿到网络错误
  • 请求体不是标准 multipart,或被代理改写了 Content-Type,服务端无法解析
  • 浏览器插件或企业代理拦截了上传域名,请求在发出前就被中断,控制台只剩一条失败
  • 后台会话已过期,上传接口回了一个重定向,前端按网络失败处理

处理步骤#

  1. 先看文件大小,超过 15 MB 就按品牌或按商品拆成多个文件
  2. 用 wc -l products.csv 数行数,单文件控制在几千行更稳
  3. 换无痕窗口并关掉广告拦截插件,再传同一个文件对比结果
  4. 用官方 sample CSV 重建表头,列名与顺序保持一致,删掉隐藏列
  5. 先导入 5 行测试数据,确认字段映射无误后再导全量

验收标准#

导入任务出现在提示里并收到完成邮件,后台商品数与 CSV 去重后的 handle 数一致,报错行数为 0。

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