如何在Insomnia.rest中用GraphQL Mutation测试文件上传？附替代工具

我来帮你解决这个GraphQL文件上传测试的问题——之前我也遇到过Insomnia的结构化GraphQL界面找不到文件字段的情况，其实是需要换一种符合文件上传规范的请求方式来实现，下面是具体步骤和替代方案：

一、在Insomnia中实现GraphQL文件上传的步骤 #

GraphQL文件上传依赖multipart/form-data格式传输，而Insomnia默认的GraphQL结构化界面不支持这种格式，所以需要手动构造请求：

1. 新建一个POST请求，填写你的GraphQL服务器端点URL
2. 切换到「Body」标签，选择「Multipart Form」类型
3. 依次添加以下三个字段：
   • 字段名：operations，类型选择JSON，填入你的Mutation查询内容（示例）：

     {
       "query": "mutation ($file: Upload!) { uploadImage(file: $file) { id url } }",
       "variables": { "file": null }
     }
     

   • 字段名：map，类型选择JSON，用来关联文件和变量：

     { "0": ["variables.file"] }
     

   • 字段名：0（对应map里的键值），类型选择File，然后选择你要上传的图片文件
4. 点击发送请求，就能完成GraphQL Mutation的文件上传测试了

这个方法完全符合GraphQL文件上传的官方规范，只是绕开了Insomnia自带的GraphQL结构化界面，用手动构造多表单数据的方式实现。

二、替代的API测试工具推荐 #

如果觉得Insomnia的这种操作太繁琐，这些工具可以更直观地支持GraphQL文件上传：

• Postman：专门做API测试的老牌工具，在GraphQL请求模式下，直接定义Upload类型的变量后，就能在变量面板选择本地文件，操作非常直观
• GraphiQL：很多GraphQL后端框架（比如Apollo Server、Hasura）自带的调试界面，原生支持文件上传，在变量输入框里直接选择文件即可，适合开发时快速调试
• curl：命令行工具，适合写自动化测试脚本，示例命令如下：

  curl -X POST \
    -F operations='{ "query": "mutation ($file: Upload!) { uploadImage(file: $file) { id url } }", "variables": { "file": null } }' \
    -F map='{ "0": ["variables.file"] }' \
    -F 0=@/Users/you/Desktop/test.jpg \
    https://your-graphql-api.com/graphql
  

• Hoppscotch：开源的Web端API测试工具，界面简洁，支持GraphQL文件上传，不需要安装客户端，直接在浏览器里就能操作

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