给接口的是文件流FormData对象，但是payload却不是FormData

### 文件上传时Payload的实际表现

当通过`FormData`对象发送文件流时，尽管前端代码中确实创建并使用了`FormData`来封装数据，但在HTTP请求中的实际负载(payload)形式取决于浏览器如何序列化这个`FormData`对象。对于文件上传场景，默认情况下，`Content-Type`会被设置为`multipart/form-data`[^1]。

#### `multipart/form-data`编码方式的特点

这种编码方式允许在一个HTTP请求体中包含多个部分(parts)，每一部分可以携带不同类型的数据——既可以是纯文本字段也可以是非文本类型的二进制数据(比如图片)[^3]。具体来说：

- 每一部分由边界线(boundary line)分隔开；
- 边界线之后跟随的是该部分内容的具体描述信息（如名称、文件名等），以及内容本身；
- 这种结构使得服务器端能够解析出哪些数据属于表单的不同组成部分，并据此处理相应的业务逻辑；

因此，在客户端构建好`FormData`实例并向其中追加路径变量或其他任何键值对后，即使看起来像是简单的key-value集合，一旦涉及到文件传输，整个请求的内容就会按照上述规则被转换成适合网络传输的形式。

let formData = new FormData();
formData.append('file', fileInput.files[0]);
// 发送前的准备工作已完成，此时formData内部存储着待上传的信息，
// 但是它的真实形态只有在网络通信过程中才会显现出来。

实际上，虽然开发者在JavaScript层面操作的对象确实是`FormData`类型，但由于HTTP协议本身的特性加上不同浏览器实现细节上的差异，最终到达服务端的数据包并不直接呈现为我们所熟悉的JS对象格式[^4]。