HarmonyOS 鸿蒙Next request.uploadFile 踩坑，以及疑似官方文档不严谨

HarmonyOS 鸿蒙Next request.uploadFile 踩坑，以及疑似官方文档不严谨 首先说明，我是 Node.js Express Multer 库做的后端，如果您使用其他技术栈，发现不存在本文描述的问题，那可以略过。

HTTP 请求，通过把 Content-Type 设置为 multipart/form-data，即可让 Body 携带文件字段。

下面是原始报文的部分：

Content-Disposition: form-data; name="file"; filename="1.jpg"
Content-Type: image/jpg

我想要表达的问题，就是报文里的这个 Content-Type，它需要客户端构建 HTTP 请求时去设置。

许多的 HTTP 构建工具，如各类 API 调试工具，如 JavaScript FormData 对象，能根据选择的文件自动设置这个文件类型。

而 ArkTS 里的 request.uploadFile，要求传入 request.File 对象，这个 File 对象包含一个 type 属性。

问题开始，下面是文档里的例子：

// 上传任务配置项
let files: Array<request.File> = [
//uri前缀internal://cache 对应cacheDir目录
  { filename: 'test.txt', name: 'test', uri: 'internal://cache/test.txt', type: 'txt' }
]

经过我测试，这个 type 属性，就是报文中的那个 Content-Type，所以如果是上面的 type: txt，那报文就会是：

Content-Disposition: form-data; name="file"; filename="test.txt"
Content-Type: txt

可是我们知道，报文中的 Content-Type 是要求满足 Mime Type 的。

再看文档这个位置：request.File，对 type 属性的描述是：文件的内容类型，默认根据文件名或路径的后缀获取。

那如果我需要上传的是 jpg 图片，按这个表述，我是不是应该设置为 type: jpg 呢？

好，我刚开始看完文档，还真就是这么设置的，然后就悲催了。

报文变成了：

Content-Disposition: form-data; name="file"; filename="1.jpg"
Content-Type: jpg

然后，后端接收到的 File 是这样的：

{
  fieldname: 'file',
  originalname: '1.jpg',
  encoding: '7bit',
  mimetype: 'text/plain'
}

可以看到，mimetype 因为我前端把 type 设置为了 jpg 而不是 image/jpg，导致后端不识别文件类型，就默认识别为了 text/plain。

所以我认为，文档最好还是把 type 描述具体一些，说明它和 Mime Type 以及报文里的 Content-Type 里的关系。

就因为这个东西，我上传文件一直报错，说上传的文件类型不被允许。

对我来说，就是因为文档描述不清晰和不具体导致的这些问题，也有可能仅限于我会这么认为，遇到了我就记录下来。