Shopify Admin API 422 与 userErrors 解读

现场信号#

422 时读 userErrors 数组，不要只看 HTTP 状态。此外，字段级校验失败会指出 field 路径与 message。此外，例如产品选项超限、变体重复、必填元字段缺失都会进 userErrors。

机制与成因#

mutation 要在一个事务语义下处理错误，部分成功时看文档是否支持。紧接着，把 userErrors 原文返回给运营，比笼统“保存失败”有用。紧接着，中文店铺也常返回英文 message，需在前端做映射。

操作顺序#

1. 先用最小 payload 成功创建，再逐步加字段定位哪个字段 422。
2. 对照 ProductInput 等输入类型的现行 schema。
3. 避免把 null 与空字符串语义搞混。
4. 批量导入遇 422 应写下标与句柄。

验收要点#

验收：故意缺必填时错误可读，补齐后成功。最后，禁止吞掉 userErrors 只打 log。