用途:为 Shopify 主题、应用和 API 集成提供调试与排错指导,适用于排查 Liquid 模板错误、主题渲染异常、GraphQL/REST API 报错、主题或应用中的 JavaScript 错误、购物车与结账问题、Webhook 投递失败、OAuth 认证问题、主题预览与自定义器问题、页面加载缓慢以及元字段/元对象访问错误、CORS 或网络请求问题。
主要能力:Liquid 调试(在主题自定义器中打开浏览器 DevTools 查看控制台错误,用 {{ product | json }} 输出变量、用 {% if product %} 判断变量是否存在,识别缺少 endif、未定义变量、过滤器名错误等);JavaScript 调试(console.log/table/group/time/trace、debugger 断点、try-catch 错误处理、Network 面板查看 XHR/Fetch 请求头与响应);API 错误调试(GraphQL 需先检查 errors 再访问 data,识别 UNAUTHENTICATED、字段不存在、限流等错误,Admin API 使用 X-Shopify-Access-Token 头,读取 X-Shopify-GraphQL-Admin-Api-Call-Limit 与 429/Retry-After;REST 处理 404、422 校验错误);购物车调试(/cart/add.js 需传变体 ID 而非产品 ID,/cart.js 查看购物车状态,处理库存不足的 422 错误);主题预览调试(section schema、section.settings、block.shopify_attributes);Webhook 调试(在后台查看最近投递记录,用 HMAC-SHA256 校验 x-shopify-hmac-sha256,5 秒内响应并异步处理)。
使用方式:在遇到上述问题时调用该技能,按对应章节操作;常用命令包括 {{ variable | json }}、console.log('Debug:', data)、debugger、fetch('/cart.js').then(r => r.json()).then(console.log)。
限制:资料未提供具体安装命令、收费方式、支持平台版本或效果保证;部分错误信息与修复方式需结合具体店铺、API 版本和权限范围验证。