Storefront API 的 errors 和 userErrors 怎么区分处理

现象#

加购失败时前端没有任何提示，只在控制台看到返回里有 errors 或 userErrors。

原因#

• 只判断了 HTTP 状态码，GraphQL 错误在响应体里
• 把 userErrors 当成成功（数组为空才是成功）
• 错误信息直接抛给用户，暴露技术细节

处理步骤#

1. 先看顶层 errors（查询语法、权限、限流），再看 mutation 的 userErrors
2. 封装统一处理：userErrors.length > 0 时取 message 映射为友好文案
3. 对 430/THROTTLED 做退避重试，其余错误提示用户
4. 把原始错误上报日志，前端只展示可理解的信息

验收标准#

失败场景都有明确用户提示，控制台可查到原始错误，重试策略生效。