Postman调用GraphQL查询返回400错误，新手求助排查方案

关键问题：你混淆了Schema和查询语句 #

你贴的是服务端的GraphQL Schema定义，这是用来约定API可用的查询结构和字段，但Postman里发起请求需要的是符合这个Schema的实际查询语句，不是直接把Schema粘进去——这是新手最容易踩的坑。

具体调整步骤 #

1. 编写正确的查询语句 #

根据你的Schema，要查询学校信息，正确的查询语句有两种写法：

写法一：使用变量（推荐，方便复用）

query GetSchool($schoolCode: String) {
  school(schoolCode: $schoolCode) {
    optionalSubjects
    code
    defaultSubjects
    defaultExams
  }
}

写法二：直接传入参数值

query {
  school(schoolCode: "你的学校编码") {
    optionalSubjects
    code
    defaultSubjects
    defaultExams
  }
}

2. GRAPHQL VARIABLES的使用说明 #

• 如果用了写法一的变量查询，必须在右侧GRAPHQL VARIABLES区域传入JSON格式的参数值：

{
  "schoolCode": "你的学校编码"
}

• 如果用了写法二直接写死值，变量区域可以留空。

3. 其他排查方向 #

• 确认请求方法是POST：GraphQL接口几乎都要求用POST请求
• 检查请求URL是否正确：必须指向服务端提供的GraphQL接口地址（比如/graphql）
• 验证请求头：确保设置了Content-Type: application/json，否则服务端无法解析请求
• 检查查询语法：比如字段名拼写错误、括号不匹配、参数类型和Schema定义不一致等，都会导致400错误

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