用途：这是一个 Shopify API 错误诊断与修复的速查参考，面向已配置 API 凭据的 Shopify 应用开发者，用于在遇到接口报错时快速匹配错误类型、定位原因并应用修复。
主要能力：覆盖常见 HTTP 状态码与 GraphQL 错误的真实响应报文、成因和修复建议。401 Unauthorized 常见于访问令牌过期、请求头错误或用 Storefront 令牌调用 Admin API；403 Forbidden 通常因缺少所需 scope（如 read_orders），需在 shopify.app.toml 的 [access_scopes] 中添加并重新触发 OAuth；404 常因 API 版本错误、资源已删除或店铺域名有误，可通过 /admin/api/versions.json 核对版本；422 多由必填字段缺失、handle/slug 重复、metafield 类型无效、价格格式问题或国家/省份代码无效引发；429 为限流，REST 返回 429 与 Retry-After 头，GraphQL 则返回 200 但体内含 THROTTLED 错误码且可用点数为零。
使用方式：先判断错误属于 HTTP 状态码还是 GraphQL userErrors，再对照条目应用修复。需特别注意 Shopify 在 mutation 失败时仍可能返回 HTTP 200，因此每次 mutation 后都应检查 userErrors。
适用场景与限制：适用于 Shopify 应用接口调试与排错。部分错误（如 429）的完整退避实现需参考 shopify-rate-limits 技能；5xx 为 Shopify 内部错误，可用指数退避重试并记录 X-Request-Id 供支持排查。仅作诊断指引，不替代具体业务逻辑修复；详细代码示例与诊断脚本请参见原资料链接。