GraphQL如何对同上下文的根Query字段进行分组（非group by）

实现思路 #

你要的嵌套分组效果是GraphQL生产环境非常常用的根字段优化方案，核心是通过定义业务域专属的查询对象类型，再统一挂载到根Query下实现归类，完全不需要依赖额外工具，原生GraphQL语法就支持。

具体实现步骤 #

1. 定义各业务域的查询类型 #

按业务上下文分别定义对应的对象类型，把原来带前缀的字段去掉前缀后放到对应类型下：

# 天气业务域查询类型
type WeatherQuery {
  current(cityId: ID!): WeatherInfo
  forecast(cityId: ID!, days: Int = 7): [WeatherForecastItem]
}

# 新闻业务域查询类型
type NewsQuery {
  rss(category: String): [NewsItem]
  current: NewsItem
}

# 用户业务域查询类型
type UserQuery {
  byId(id: ID!): UserInfo
}

2. 重构根Query类型 #

根Query下不再放零散的业务字段，只保留各个业务域的入口字段，原有字段可加弃用标记做过渡兼容：

type Query {
  weather: WeatherQuery
  news: NewsQuery
  user: UserQuery
  # 原有带前缀的字段可暂时保留，等业务侧全量切走后再下线
  weatherCurrent(cityId: ID!): WeatherInfo @deprecated(reason: "请使用 weather.current 代替")
}

3. 适配Resolver逻辑 #

• 根Query下的业务域入口字段（比如weather）只需要写一个极简Resolver，直接返回空对象即可（部分GraphQL框架甚至可以省略这个Resolver，会自动透传执行子字段逻辑）
• 原来的字段Resolver从根Query下移到对应业务域类型下即可，业务逻辑基本不需要改造，比如原来的weatherCurrentResolver直接改成WeatherQuery下的currentResolver就行

以Node.js的Apollo Server为例，Resolver适配后示例：

const resolvers = {
  Query: {
    weather: () => ({}), // 仅作为入口透传
    news: () => ({}),
    user: () => ({})
  },
  WeatherQuery: {
    current: (parent, args, context) => {
      // 原有weatherCurrent的业务逻辑直接复用
      return getCurrentWeather(args.cityId)
    },
    forecast: (parent, args, context) => {
      return getForecast(args.cityId, args.days)
    }
  },
  NewsQuery: {
    // 新闻相关字段Resolver
  }
}

额外优化点 #

• 可以在业务域入口Resolver统一做该域的权限校验、频率控制等通用逻辑，不用每个子字段重复实现
• 嵌套层级建议控制在2层以内，避免查询结构过于复杂增加调用方理解成本

内容的提问来源于stack exchange，提问作者Stefan