.NET Core WebAPI 基础文件上传

在.NET Core WebAPI中，文件上传是一个常见的需求。本篇文章将指导你如何在.NET Core WebAPI中实现基础的文件上传功能。

1. 创建.NET Core WebAPI项目

首先，你需要使用Visual Studio或.NET CLI创建一个新的.NET Core WebAPI项目。

使用Visual Studio:

1. 打开Visual Studio。

2. 选择“创建新项目”。

3. 在项目模板中选择“ASP.NET Core Web Application”。

4. 输入项目名称和位置，然后点击“创建”。

5. 在“创建新的ASP.NET Core Web Application”窗口中，选择“.NET Core”和“API”，然后点击“创建”。

使用.NET CLI:

dotnet new webapi -n FileUploadApi
cd FileUploadApi

2. 配置文件上传

在.NET Core WebAPI中，处理文件上传通常使用IFormFile接口。你需要在你的Controller中创建一个Action来接收上传的文件。

首先，在Startup.cs中配置CORS（跨源资源共享）策略以允许前端应用上传文件：

public class Startup
{
    // ... 其他配置 ...

    public void ConfigureServices(IServiceCollection services)
    {
        services.AddControllers();
        services.AddCors(options =>
        {
            options.AddPolicy("MyCorsPolicy", builder =>
            {
                builder.AllowAnyOrigin() // 允许任何来源的请求
                       .AllowAnyHeader() // 允许任何头信息
                       .AllowAnyMethod(); // 允许任何HTTP方法
            });
        });
    }

    public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
    {
        // ... 其他中间件配置 ...
        app.UseCors("MyCorsPolicy"); // 使用CORS策略
        app.UseRouting();
        app.UseAuthorization();
        app.UseEndpoints(endpoints => { endpoints.MapControllers(); });
    }
}

然后，在你的Controller中添加一个用于处理文件上传的Action。例如，在FileUploadController中添加一个Post方法来接收上传的文件：

[ApiController]
[Route("[controller]")]
public class FileUploadController : ControllerBase
{
    [HttpPost]
    public async Task<IActionResult> UploadFile(IFormFile file)
    {
        if (file == null || file.Length == 0)
            return BadRequest("No file uploaded.");

        var savePath = Path.Combine(Directory.GetCurrentDirectory(), "uploads", file.FileName);

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

        return Ok(new { fileName = file.FileName, size = file.Length });
    }
}

在这个例子中，我们创建了一个名为UploadFile的POST方法，它接收一个IFormFile参数。这个方法会检查上传的文件是否存在且大小不为0。然后，它将文件保存到服务器的"uploads"文件夹中，并返回一个包含文件名和大小的响应。

3. 测试文件上传功能

现在，你可以使用Postman、Curl或任何你喜欢的HTTP客户端来测试你的文件上传API。确保你使用multipart/form-data作为请求的内容类型，并将文件作为请求的一部分发送。

4. 注意事项和安全性考虑

• 文件大小限制：默认情况下，ASP.NET Core对上传的文件大小有限制。你可以在Startup.cs的ConfigureServices方法中配置这些限制。

• 文件类型验证：你应该验证上传的文件类型，以防止用户上传恶意文件。可以通过检查文件的MIME类型或文件扩展名来实现。

• 文件保存位置：确保将上传的文件保存在Web服务器的安全位置，并防止未经授权的访问。

• 错误处理：在实际应用中，你应该添加适当的错误处理逻辑来处理文件上传过程中可能出现的任何问题。

• CORS策略：确保你的CORS策略是安全的，只允许来自可信任的源的请求。在生产环境中，你应该避免使用AllowAnyOrigin和AllowAnyHeader，而是明确指定允许的源和头信息。

结论

在.NET Core WebAPI中实现文件上传功能是一个相对简单的任务。通过使用IFormFile接口和适当的配置，你可以轻松地接收和处理上传的文件。然而，安全性是非常重要的考虑因素，因此你应该始终验证上传的文件类型、大小以及来源，并确保将文件保存在安全的位置。