REST 迁到 GraphQL 后字段缺失怎么补

现象#

按旧文档改完接口，返回里找不到原来 REST 就有的字段（如库存、图片地址、折扣明细），查询直接被拒。

原因#

• GraphQL 需要显式声明字段，且不少字段被拆成子对象或 edges/node 结构
• 部分 REST 字段在 GraphQL 里改了名字或类型（金额由字符串变 MoneyV2）
• 访问某些字段需要额外的 access scope，缺失时字段直接不返回
• 查询里用了已被移除的字段，整条查询报错而不是部分返回

处理步骤#

1. 用 GraphiQL 或 Admin API 的 schema 检索目标字段，确认准确名称与类型
2. 金额统一按 MoneyV2 { amount currencyCode } 取，不要再用顶层字符串
3. 列表用 edges { node { ... } } 或 nodes，按官方示例改写
4. 核对应用的 scope 是否覆盖新字段，缺权限先补授权再重试

验收标准#

迁移后的查询返回字段与业务所需完全对齐；无 Field doesn't exist 报错。