Postman中form-data请求字段顺序导致GraphQL文件上传报错

这个问题我之前帮人排查过好几次，核心原因就是multipart/form-data字段的顺序不对——你的GraphQL服务器严格遵循了文件上传的约定：必须先传operations和map字段，最后才传文件本身。你的curl命令是符合这个顺序的，但Postman或者手动构建请求时搞反了顺序，所以触发了那个错误。

下面给你具体的解决步骤：

针对Postman的修复操作 #

1. 打开你的POST请求，切换到Body标签，确认选中form-data类型
2. 按照严格的顺序添加三个字段（可以拖动字段左侧的六点图标调整顺序）：
   • 第一个字段：
     • 键：operations
     • 类型：Text
     • 值：

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

   • 第二个字段：
     • 键：map
     • 类型：Text
     • 值：

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

   • 第三个字段：
     • 键：0
     • 类型：File
     • 选择你的a.txt文件
3. 保存设置后重新发送请求，应该就能正常上传了

手动构建form-data请求的通用注意事项 #

不管你用什么工具（比如fetch、axios或者其他HTTP客户端），构建multipart表单时必须保证字段顺序是：

• 先operations（包含GraphQL查询和变量定义）
• 然后map（定义文件字段和变量的映射关系）
• 最后是实际的文件字段（对应map里的键，比如这里的0）

很多GraphQL上传的实现（比如Apollo Server的旧版本、一些自定义的服务器逻辑）会校验这个顺序，因为它们需要先解析operations和map来知道如何处理后续的文件，所以顺序错了就会抛出"文件应该跟随map"的错误。

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