用途:这是一个面向 Shopify 主题、应用与 API 集成的调试排错技能,在遇到 Liquid 模板报错、主题渲染异常、API 错误、JavaScript 报错、购物车或结账问题、Webhook 投递失败、OAuth 认证、主题预览异常、页面加载过慢、metafield 访问错误以及 CORS 或网络请求问题时调用。
主要能力:涵盖 Liquid 调试(通过主题编辑器与浏览器控制台查看报错,使用 {{ product | json }} 输出变量、判断变量是否存在),JavaScript 调试(console.log、console.table、console.group、console.time、debugger 断点与 try-catch 错误处理),GraphQL 与 REST API 错误排查(先检查 errors 再访问 data,识别 UNAUTHENTICATED、字段不存在、429 限流,读取 X-Shopify-GraphQL-Admin-Api-Call-Limit 与 Retry-After,处理 404、422),购物车调试(/cart/add.js 需传变体 ID、/cart.js 查看状态、库存不足报错),主题预览调试(section schema 与 settings 配置、block.shopify_attributes),Webhook 调试(校验 X-Shopify-HMAC-SHA256、5 秒内响应并异步处理),以及常见错误信息与修复建议。
使用方式:可与 shopify-liquid、shopify-api、shopify-theme-dev、shopify-app-dev、shopify-performance 等技能配合使用。常用手段包括浏览器 DevTools 的 Console、Network、Sources、Application、Performance 面板,Shopify 的主题预览、Theme Inspector、API Explorer 和 Webhook 投递日志。
限制:资料未提供收费、价格与具体平台支持等信息。示例代码仅为排错思路,实际请结合店铺 API 版本与权限核对。