Shopify 报错排障
Shopify 的报错文案大多很短，HTML error found、Liquid syntax error、OAuth error 这类提示本身不含位置信息。本分类把这些高频报错逐个拆开，说明它通常由什么操作触发、去哪里看详细日志、以及改完怎样确认真的修好了。
-
01
后台报 502 Bad Gateway 是店铺挂了吗
打开后台某个页面或点保存时浏览器显示 502 Bad Gateway，刷新几次又恢复……
-
02
Admin API 返回的 errors 字段怎么读
调 REST Admin API 创建商品返回 422，body 里 errors 有时是字符串、有时是对象……
-
03
装应用后购物车异常怎么排查
加购后购物车数量不更新、金额算错，或点击结账跳回首页；停用应用后恢复正常。
-
04
CSV 导入报 illegal quotes 怎么修
导入结果页显示 Line 12 has illegal quotes，从第 12 行开始的商品全部没入库……
-
05
商品导入报 Failed to fetch 怎么解决
在商品页点导入上传 CSV，进度条走完后弹出 Failed to fetch，页面不给行号……
-
06
主题自定义 CSS 报 Invalid CSS 怎么修
在主题编辑器某个 section 的自定义 CSS 框里粘贴一段带 @media 的样式……
-
07
后台一直 ERR_TOO_MANY_REDIRECTS 怎么修
访问店铺主域名时浏览器报 ERR_TOO_MANY_REDIRECTS，地址栏在 http 与 https……
-
08
发货报 fulfillment order not assigned
用自建发货服务给订单发货，fulfillmentCreate 返回 The fulfillment order is……
-
09
Shopify 报错 HTML error found 怎么解决
主题检查或编辑器提示发现超文本标记错误，结构不匹配，可能影响渲染或可访问性。
-
10
Invalid API key or access token 排查
请求 /admin/api/2025-07/graphql.json 返回 401……
-
11
库存报 The quantity can't be negative
用 inventorySetQuantities 把某地点可用量改成 -5 想表示超卖，接口返回 200……
-
12
Liquid 报 String 与 0 比较失败怎么修
集合页按价格区间筛选时整个商品列表消失，源码里留下 Liquid error (snippets/filter li……
-
13
Liquid error divided by 0 怎么定位
商品页价格下方变成一行灰字 Liquid error (snippets/price line 18): divid……
-
14
Liquid 渲染嵌套过深报错怎么拆
页面报 Nesting too deep 或直接超时，主题里 snippet 互相调用。
-
15
Shopify Liquid syntax error 怎么定位
主题编辑器或店面出现液态模板语法错误提示，页面空白或某块 section 无法渲染。
-
16
控制台报 net::ERR_ABORTED 要不要管
控制台一片 net::ERR_ABORTED，点加入购物车没反应……
-
17
结账提示 no shipping methods available
顾客在结账页填完地址，配送方式一栏显示 There are no shipping methods availabl……
-
18
Shopify OAuth error invalid_request 排查
安装或授权应用时出现开放授权错误，提示无效请求，无法完成安装。
-
19
OAuth 报 invalid_scope 是哪里配错
安装应用时浏览器跳到 Shopify 授权页……
-
20
OAuth 报 shop_not_permitted 怎么解决
用 client_credentials 换 token……
-
21
后台保存报 problem saving your changes
在产品编辑页改完标题或价格点保存，右上角弹出红色提示 There was a problem saving your……
-
22
结账报 unable to accept payments 怎么查
顾客点去付款后页面顶部出现 This store is currently unable to accept pay……
-
23
店铺前台 500 但后台正常怎么定位
顾客打开首页报 500 或空白页，后台一切正常，切换主题后恢复正常。
-
24
改主题后全站样式丢失怎么恢复
改完 theme.liquid 或上传新样式后，前台变成无样式纯文本，图片也不显示。
-
25
批量操作报 action couldn't be completed
在商品列表勾选 200 多个商品后点批量编辑……
-
26
Shopify 站点偶发 503 或 429 是什么原因
高峰期部分用户看到 503 Service Unavailable 或 429 Too Many Requests……
-
27
Shopify 后台保存一直转圈超时怎么办
编辑商品或主题时点保存一直转圈，最后提示出错，改动没保存上。
-
28
Shopify 页面某个区块空白但不报错怎么查
首页中间一块内容完全不显示，控制台没有错误，编辑器里该 section 显示正常。
-
29
Shopify 结账按钮点了没反应怎么办
商品页点「立即购买」或购物车点「去结账」无反应，也不跳转，控制台可能有报错。
-
30
Shopify 前台请求第三方接口报 CORS 怎么解
浏览器控制台报 blocked by CORS policy，接口在 Postman 里能正常返回。
-
31
Shopify 图片明明存在却返回 404 怎么处理
后台能看到图片，前台部分用户加载失败，直接访问 CDN 地址有时 404。
-
32
Shopify 切换语言后页面 404 怎么修
点语言切换后跳到 /zh-cn/... 但返回 404，或跳到首页。
-
33
Shopify 移动端布局错乱但桌面正常怎么修
手机上内容溢出屏幕、按钮被挤到看不见，桌面端完全正常。
-
34
Shopify 站内搜索搜不到商品怎么排查
输入商品名的一部分搜不到，或中文关键词完全没有结果。
-
35
Shopify 改了内容用户还看到旧版怎么办
自己改了主题或商品，部分用户反馈还是老样子，清缓存后才正常。
-
36
主题编辑器改动保存后丢失怎么恢复
在编辑器里调好首页，过一会刷新又变回原样；或者发布后前台没变化。
-
37
Shopify 定时任务与报表时区不一致怎么办
设置的每日 0 点任务实际在早上 8 点执行，报表日期与后台对不上。
-
38
Shopify 模板 invalid JSON 报错怎么排查
无法渲染模板或提示无效的杰森结构，在线商店编辑器打不开某模板，或保存模板失败。
-
39
应用报 undefined method for nil 怎么查
自建应用在 OAuth 回调里抛 NoMethodError: undefined method 'shop' fo……
-
40
找 Shopify 支持前先取 x-request-id
后台操作偶发失败，提示只有一句出了点问题，截图发给支持后被要求提供 request id，却不知道去哪里找这一串字符。
