如何在Postman中为GraphQL的Upload类型字段设置变量参数

GraphQL的Upload标量是专门处理文件上传的特殊类型，不能直接在JSON格式的GraphQL Variables中写入文件路径或二进制内容，需要按照多部分表单请求规则调整Postman配置，操作步骤如下：

• 切换请求体格式
  将Postman请求体从默认的GraphQL格式切换为form-data，按规则添加3类表单字段：

  1. 第一个字段key为operations，value为完整的GraphQL请求JSON结构，示例如下：

  {
    "query": "mutation CreateMutation($my_id: ID!, $my_data: input_data!) { createMutation(my_id: $my_id, my_data: $my_data) { 此处填写你需要返回的字段 } }",
    "variables": {
      "my_id": "实际传入的my_id值",
      "my_data": {
        "some_key": 123,
        "file": null
      }
    }
  }
  

  注意Upload类型的file字段在variables中先填null占位即可。

• 配置文件映射规则
  第二个字段key为map，value为JSON格式的文件路径映射，示例如下：

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

  其中0是后续上传文件的表单序号，后面的字符串对应variables中Upload字段的完整层级路径。

• 添加上传文件
  第三个字段key填0，点击key输入框右侧的下拉选项，将类型从「Text」切换为「File」，再点击value栏选择本地要上传的文件即可。

多文件上传只需按序号扩展map配置即可，比如同时上传两个文件的map配置为{"0": ["variables.my_data.file1"], "1": ["variables.my_data.file2"]}，再对应添加key为1的文件字段即可。

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