hoppscotch中graphql mutation失败需检查五方面：一、mutation语句与变量json格式是否符合schema；二、headers中authorization或api key是否正确配置；三、自托管时默认端点是否更新为实际graphql地址；四、是否启用schema自省校验签名；五、通过浏览器network面板排查cors、错误响应等底层问题。
如果您在Hoppscotch中尝试执行GraphQL Mutation操作但未获得预期响应或返回错误，则可能是由于请求结构、变量格式、认证头配置或端点路径不匹配所致。以下是完成Mutation测试的多种实操路径：
一、正确设置Mutation查询语句与变量
GraphQL Mutation必须以mutation关键字开头，并确保其名称、参数结构与后端Schema严格一致；Variables区域需以合法JSON格式提供输入，字段名和类型须与schema中定义的input类型完全对应。
1、在Hoppscotch左侧编辑区顶部选择GraphQL模式，确认当前标签页为Query而非REST。
2、在主查询编辑框中输入标准Mutation语句，例如：mutation CreateUser($input: CreateUserInput!) { createUser(input: $input) { id name email } }
3、切换到Variables标签页，在文本框中输入对应JSON变量，例如：{"input": {"name": "Alice", "email": "alice@example.com"}}
4、点击Send按钮执行请求，观察右侧响应区域是否返回data.createUser结构。
二、配置认证请求头（Bearer Token / API Key）
Hoppscotch通过Headers标签页注入认证信息，Mutation操作若受权限保护，缺少有效Authorization头将直接被服务端拒绝，返回401 Unauthorized或空data字段。
1、点击Headers标签页，确保Enable headers开关已开启。
2、在第一行Key栏输入Authorization，Value栏输入Bearer <strong><font color="green">your-jwt-token-here</font></strong>（注意含空格）。
3、若后端使用API Key方式，Key设为X-API-Key，Value设为<strong><font color="green">abc123def456</font></strong>。
4、发送请求前检查Headers列表中无重复键，且大小写与服务端要求一致（如部分服务区分authorization与Authorization）。
三、验证并修正自托管环境的GraphQL端点URL
当Hoppscotch为自托管部署时，其默认GraphQL请求URL仍指向https://echo.hoppscotch.io/graphql，若未手动修改为本地后端地址，所有Mutation请求将发往错误域名，导致Network Error或502 Bad Gateway。
1、点击右上角Settings（齿轮图标），进入General设置页。
2、向下滚动至GraphQL模块，找到Default GraphQL endpoint输入框。
3、将其值替换为实际部署的GraphQL服务地址，例如：<strong><font color="green">http://localhost:4000/graphql</font></strong>或<strong><font color="green">https://api.yourdomain.com/api/graphql</font></strong>。
4、关闭设置页，新建一个GraphQL请求标签页，确认左上角URL显示已更新为新地址。
四、启用Schema自省并校验Mutation签名
Hoppscotch内置Schema自省功能可动态加载服务端完整类型定义，用于实时验证Mutation名称、参数名、必填性（!）及返回类型，避免因拼写错误或缺失非空字段导致解析失败。
1、确保当前GraphQL请求URL已正确配置并可访问（可通过浏览器直接GET该URL验证返回是否为GraphQL Playground或Schema JSON）。
2、点击编辑区右上角⚙️图标，选择Fetch schema，等待状态变为✅ Schema fetched。
3、点击Docs按钮打开右侧文档面板，展开Mutation节点，查找目标操作（如createUser）。
4、核对文档中显示的参数列表，确认input字段是否为非空对象类型，以及其内部字段（如name!）是否已在Variables中提供值。
五、调试网络请求与响应体细节
当Mutation返回errors数组或data为null时，需借助浏览器开发者工具捕获原始HTTP请求与响应，排查底层传输层问题，例如CORS拦截、JSON解析失败或GraphQL解析器抛出的内部异常。
1、在浏览器中按F12打开开发者工具，切换到Network标签页。
2、在Filter栏输入graphql，清空现有记录后点击Hoppscotch中的Send按钮。
3、定位到新生成的fetch或XHR请求，点击查看详情，查看Headers中Request URL与Request Payload是否符合预期。
4、切换至Response标签页，检查原始响应内容：若含"errors": [{"message": "..."}]，则问题在服务端逻辑；若响应为空或status 0，则为跨域或连接中断。
