如何在 .NET Core WebApi 中处理 MultipartFormDataContent

最近在对某个后端服务做 .NET Core 升级时，里面使用了多处处理 MultipartFormDataContent 相关内容的代码。这些地方从 .NET Framework 迁移到 .NET Core 之后的代码改动较大，由于本身没有测试覆盖，导致在部署 QA 环境后引发了一些问题。这里做一个技术复盘。

什么是 MultipartFormDataContent#

我们在做后端接口开发的时候，常常会涉及到接口参数为多种类型的情况，比如值类型，引用类型，或者是文件类型。如果我们需要在一个接口参数中同时传递多种不多的数据类型，那么这个时候就需要用到 multipart/form-data MIME 类型进行内容编码，然后传递给后端。比如我们需要往后端接口传递一个同时包含文件和字符串文本的话，使用 Postman 你可以这样构造内容：

对应的 HTTP 请求内容则类似是这样：

MultipartFormDataContent 的写操作#

在 C# 中，我们通常会使用 HttpClient 这个类型的实例对象来进行接口请求，对应实例代码如下所示：

在这个请求构造中，我们尝试在内存中创建一个压缩文件 test.zip，然后再构造一个简单的文本内容，并将这两部分内容统一放到Body 中通过 HttpClient 发送到后端。

MultipartFormDataContent 的读操作#

.NET Framework#

在传统 Framework 项目中，我们可以通过构造出 MultipartMemoryStreamProvider 类型来方便解析接收到的 MultipartFormDataContent 对象，但是由于这个类型在 .NET Core 中已经被不存在，所以我们需要尝试新的方法来重构这一块的代码。

.NET Core#

方式一#

由于接收到的 MultipartFormDataContent 对象内部是由多个 Section 所组成，所以我们可以通过循环每个 Section 的方式来分别解析所有内容。

⚠️ 这种读取方式较复杂，并且从目前已经使用过这种方式的服务来讲的话，建议要有对应的测试覆盖。

方式二#

这种方式是通过借助 ASP.NET Core 本身的框架封装，将原本复杂的 MultipartFormDataContent 直接放到 Request.Form 中，所以我们只需要通过这个对象来拿我们想要的数据即可。（PS：如果从 Request.Form 中获取 Files，这个地方会有一个坑，下文会讲到。）