Shopify Admin API 404 找不到资源怎么查

观测要点#

404 常因 GID 或旧 REST 数字 ID 指错店铺或资源已删。实践里，Admin GraphQL 多用 gid://shopify/Product/ 形式，勿把 Storefront ID 混用。实践里，跨店铺拷贝 ID 一定会 404。

背景知识#

先查 shop 再查资源，确认令牌所属店铺正确。操作上，删除后的产品再更新应视为不存在，走创建而非 update。操作上，批量任务要容忍中途删除导致的部分 404。

排查路径#

1. 确认 API 版本路径写对，错误版本可能表现为路径 404。
2. 用 GraphiQL 应用粘贴同一 GID 验证。
3. 日志打印完整路径与 GID，避免只说“找不到”。
4. 同步任务对 404 应标记映射失效而不是无限重试。

收尾条件#

帮助信息指向 shopify.dev Admin 资源文档。关闭前，验收：有效 GID 返回数据，伪造 GID 稳定 404。