GraphQL使用fragment创建嵌套contactInfo查询报错如何解决

DevOps 小满

2026-8-26

问题原因

你写的片段（fragment）存在两个核心错误：

GraphQL 语法不支持字段名: { 子字段 }这种直接声明嵌套对象的写法
Fragment 的本质是复用同类型下已存在的字段选择集合，它不能凭空创造 schema 里没有定义的父级字段，也不能随意修改返回结果的数据层级。

对应解决方案

分两种场景处理：

场景1：服务端Schema本身已经定义了`contactInfo`字段

如果person类型下本身就存在contactInfo这个对象类型字段，且该字段下挂载了phone、email两个子字段，只需要修正fragment的语法即可：

# 正确的fragment定义
fragment contactInfo on person {
  contactInfo {
    phone
    email
  }
}

这时候你原来的查询写法可以正常运行，返回结果会自动带出嵌套的contactInfo对象：

info {
  firstname
  lastname
  ...contactInfo
}

返回结构示例：

{
  "data": {
    "info": {
      "firstname": "xxx",
      "lastname": "xxx",
      "contactInfo": {
        "phone": "xxx",
        "email": "xxx"
      }
    }
  }
}

场景2：服务端Schema没有定义`contactInfo`字段

如果phone、email是直接挂载在person类型根层级的字段，schema里根本不存在contactInfo这个父字段，没有任何GraphQL原生写法可以靠fragment凭空套一层嵌套结构，可选的解决方式只有两个：

修改服务端Schema定义：在person类型下新增contactInfo对象类型，把phone、email归到该类型下，之后参考场景1的写法即可
客户端做数据转换：查询时正常选根层级的phone、email字段，拿到返回结果后在前端/客户端代码里手动把两个字段拼装成contactInfo对象结构。