如何在GraphQL API中设置root query/mutation全局请求参数

推荐方案1：使用GraphQL标准请求扩展字段（extensions） #

GraphQL官方规范明确允许请求体携带extensions自定义扩展字段，属于标准能力，完全不需要hack：

• 不绑定HTTP协议，WebSocket、RPC等其他GraphQL传输方式都可通用
• 可在服务端自行定义extensions内全局参数的类型、校验规则，天然支持限制单请求仅传一次
• 可将参数定义同步到Schema文档中，解决规范化展示问题
• 不会污染查询语句结构，业务侧查询写法无冗余

请求示例：

POST /graphql
...

{
  "query": "{someQuery{id name}}",
  "variables": {},
  "extensions": {
    "myArg": "some-value"
  }
}

目前主流GraphQL服务框架（Apollo、GraphQL Java、Gqlgen等）都原生支持读取extensions字段，可在全局中间件中统一解析后注入上下文，供所有query/mutation的resolver读取使用。

推荐方案2：使用自定义操作级指令 #

如果需要将参数完全纳入GraphQL语法体系、支持客户端静态校验，可使用GraphQL标准的自定义指令能力：

1. 首先在Schema中定义全局参数对应的指令，仅允许作用于QUERY/MUTATION操作：

# 该定义会自动展示在Schema文档中
directive @myArg(arg: String!) on QUERY, MUTATION

2. 客户端使用时直接在操作声明处添加指令即可，天然限制单操作最多声明一次：

# 硬编码参数写法
query @myArg(arg: "some-value") {
  someQuery { id name }
}

# 变量传参写法
query($val: String!) @myArg(arg: $val) {
  someQuery { id name }
}

该方案完全符合GraphQL规范，参数类型、说明会自动同步到Schema文档，不需要修改业务查询的字段结构，服务端可在全局解析阶段读取指令参数注入上下文，完全满足你的需求。

上述两种方案都是GraphQL规范原生支持的能力，不需要对框架做hack改造，也能解决你提到的现有方案的所有痛点。

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