无法在Asp.Net核心3.1API中上传文件

基础概念

ASP.NET Core 3.1 是一个开源的、跨平台的框架，用于构建现代、云基础的、连接的应用程序。它支持多种编程语言，包括 C# 和 VB.NET。在 ASP.NET Core 中，文件上传通常通过 IFormFile 接口实现。

类型

简单文件上传：单个文件的上传。
多文件上传：多个文件的同时上传。

应用场景

用户头像上传：用户可以在个人资料页面上传头像。
文档管理：用户可以上传和下载文档。
图片分享：用户可以上传图片并分享到社交平台。

问题描述

在 ASP.NET Core 3.1 API 中无法上传文件，可能是由于多种原因导致的。

可能的原因及解决方法

1. 表单数据未正确配置

确保在 HTML 表单中设置了 enctype="multipart/form-data"，并且使用了 POST 方法。

<form method="post" enctype="multipart/form-data">
    <input type="file" name="file" />
    <button type="submit">Upload</button>
</form>

2. 控制器方法未正确处理文件

确保控制器方法接收 IFormFile 参数，并正确处理文件上传。

[HttpPost("upload")]
public async Task<IActionResult> UploadFile(IFormFile file)
{
    if (file == null || file.Length == 0)
        return Content("No file selected");

    var path = Path.Combine(
                        Directory.GetCurrentDirectory(), "wwwroot",
                               file.FileName);

    using (var stream = new FileStream(path, FileMode.Create))
    {
        await file.CopyToAsync(stream);
    }
    return Ok();
}

3. 配置中间件

确保在 Startup.cs 中配置了 MultipartBodyLengthLimit，以允许上传大文件。

public void ConfigureServices(IServiceCollection services)
{
    services.Configure<FormOptions>(options =>
    {
        options.MultipartBodyLengthLimit = int.MaxValue; // 设置最大长度
    });
    services.AddControllers();
}

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    if (env.IsDevelopment())
    {
        app.UseDeveloperExceptionPage();
    }

    app.UseRouting();

    app.UseEndpoints(endpoints =>
    {
        endpoints.MapControllers();
    });
}

4. 文件大小限制

检查服务器配置文件（如 appsettings.json）中的 MaxRequestBodySize 设置，确保它足够大以容纳上传的文件。

{
  "Kestrel": {
    "Endpoints": {
      "Http": {
        "Url": "http://localhost:5000",
        "MaxRequestBodySize": "10485760" // 10MB
      }
    }
  }
}