#yyds干貨盤點(diǎn)#想說愛你不容易 | 使用最小 WEB API 實(shí)現(xiàn)文件上傳
2022-02-14 14:14:01

前言

在 .NET 6 之前，實(shí)現(xiàn)文件上傳功能十分簡(jiǎn)單：

[HttpPost("upload")]
public async Task<IActionResult> Upload(IFormFile file)
{
    //對(duì)file執(zhí)行操作

    return Ok(file.FileName);
}

但是，當(dāng)使用 .NET 6 的最小 WEB API 來實(shí)現(xiàn)相同功能時(shí)，卻意外地遇到了不少坑。

實(shí)現(xiàn)代碼

轉(zhuǎn)換為最小 WEB API 來實(shí)現(xiàn)后，代碼是這樣的：

app.MapPost("/upload", async (IFormFile file) =>
{
    return Results.Ok(file.FileName);
})；

但是，在使用相同的客戶端代碼調(diào)用時(shí)，卻返回了 HTTP 415 錯(cuò)誤:

允許 Content Type

這是由于上傳文件時(shí)，使用的 Content-Type 不是默認(rèn)的 ??application/json???，而是 ??multipart/form-data??

在 dotnet/aspnetcore 的 issues 中，我們找到了相關(guān)解決方案（https://github.com/dotnet/aspnetcore/issues/35082）：

修改代碼如下：

app.MapPost("/upload", async (IFormFile file) =>
{
    return Results.Ok(file.FileName);
}).Accepts<IFormFile>("multipart/form-data");

結(jié)果，還是返回了415錯(cuò)誤。更奇怪的是，多出來了一堆錯(cuò)誤堆棧信息:

驚現(xiàn) BUG

于是，想通過查看代碼方式找到問題。

使用錯(cuò)誤信息“Expected a supported JSON media type but got”，我們定位到了源代碼文件 ??Http/Http.Extensions/src/RequestDelegateFactory.cs??:

但是，發(fā)現(xiàn) master 分支和 v6.0.0 分支的代碼，差別巨大。比如，master 分支有 ??IFormFile?? 相關(guān)代碼，而 v6.0.0 上完全沒有：

查看該文件的提交歷史，我們找到了這樣一條提交：

根據(jù)提交，我們找到了對(duì)應(yīng)的 issue（https://github.com/dotnet/aspnetcore/issues/34303）：

#yyds干貨盤點(diǎn)#

看來，要想支持 ??IFormFile?? 參數(shù)，我們得等到2022年11月（.NET 7 預(yù)計(jì)發(fā)布日期）?。?！

解決方案

幸好，該 issue 也提供了變通的解決方案，傳入 HttpRequest 參數(shù):

app.MapPost("/upload",
    async (HttpRequest request) =>
    {
        var form = await request.ReadFormAsync();

        return Results.Ok(form.Files.First().FileName);
    });

驗(yàn)證成功。

結(jié)論

后面，我也嘗試過在 .NET 6 中用以前的 Controller 方式實(shí)現(xiàn)，完全沒問題。

看來最小 WEB API 是不同的實(shí)現(xiàn)機(jī)制，不確定還有不有其他的坑。

建議：最小 WEB API 暫時(shí)不要用于生產(chǎn)項(xiàng)目。

如果你覺得這篇文章對(duì)你有所啟發(fā)，請(qǐng)關(guān)注我的個(gè)人公眾號(hào)”My IO“