ASP.NET Core中直接上传文件至AWS S3的方法咨询

嗨，别担心，新手遇到这类问题太正常啦！我来帮你搞定不用存本地直接把上传的PDF、JPEG文件传到AWS S3的方案，这样既省了本地存储的开销，流程也更高效～

核心思路 #

ASP.NET Core中接收的IFormFile对象本身就包含了文件的流，我们可以直接把这个流传给AWS S3的SDK，完全不需要先写到本地硬盘。

具体实现步骤 #

1. 安装AWS S3 SDK包 #

首先在你的项目里安装AWSSDK.S3 NuGet包，可以通过NuGet包管理器或者命令行安装：

Install-Package AWSSDK.S3

2. 配置AWS S3客户端 #

在Program.cs里添加AWS S3客户端的依赖注入，这样后续可以直接在Controller里注入使用：

var builder = WebApplication.CreateBuilder(args);

// 添加AWS S3客户端服务
builder.Services.AddAWSService<IAmazonS3>();

// 其他配置...

var app = builder.Build();

// 中间件配置...

app.Run();

注意：AWS的凭证可以通过环境变量、本地AWS配置文件（~/.aws/credentials）或者如果你的应用部署在AWS服务（比如ECS、EC2）上，可以直接使用IAM角色，不需要手动配置凭证。

3. 编写文件上传接口 #

在你的Controller里写一个POST接口，接收上传的文件并直接传到S3：

using Amazon.S3;
using Amazon.S3.Model;
using Microsoft.AspNetCore.Http;
using Microsoft.AspNetCore.Mvc;

namespace YourNamespace.Controllers;

[ApiController]
[Route("[controller]")]
public class FileController : ControllerBase
{
    private readonly IAmazonS3 _s3Client;
    // 可以把桶名放在配置文件里，这里直接写示例值
    private const string BucketName = "your-s3-bucket-name";

    public FileController(IAmazonS3 s3Client)
    {
        _s3Client = s3Client;
    }

    [HttpPost("upload")]
    public async Task<IActionResult> Upload([FromForm] IFormFile file)
    {
        if (file == null || file.Length == 0)
        {
            return BadRequest("请选择要上传的文件");
        }

        // 处理文件名：避免重名可以用Guid生成唯一名称，保留原扩展名
        var fileExtension = Path.GetExtension(file.FileName);
        var s3FileName = $"{Guid.NewGuid()}{fileExtension}";

        using var fileStream = file.OpenReadStream();

        var putRequest = new PutObjectRequest
        {
            BucketName = BucketName,
            Key = s3FileName, // S3中存储的文件名
            InputStream = fileStream,
            ContentType = file.ContentType, // 设置文件的MIME类型，方便后续下载识别
            // 如果需要设置文件的公开读取权限，可以添加下面的配置
            // CannedACL = S3CannedACL.PublicRead
        };

        await _s3Client.PutObjectAsync(putRequest);

        return Ok(new 
        { 
            Message = "文件上传成功", 
            S3FileName = s3FileName,
            // 如果设置了PublicRead，可以返回文件的访问URL
            // FileUrl = $"https://{BucketName}.s3.amazonaws.com/{s3FileName}"
        });
    }
}

4. 编写文件下载接口 #

接下来写一个GET接口，根据S3里的文件名下载文件：

[HttpGet("download/{s3FileName}")]
public async Task<IActionResult> Download(string s3FileName)
{
    var getRequest = new GetObjectRequest
    {
        BucketName = BucketName,
        Key = s3FileName
    };

    using var getResponse = await _s3Client.GetObjectAsync(getRequest);
    using var responseStream = getResponse.ResponseStream;

    // 返回文件流，设置正确的MIME类型和下载文件名
    return File(
        fileStream: responseStream,
        contentType: getResponse.Headers.ContentType,
        fileDownloadName: Path.GetFileName(s3FileName) // 这里可以换成原文件名，如果你之前保存了的话
    );
}

一些额外的注意事项 #

• 文件大小限制：ASP.NET Core默认限制上传文件大小为30MB，如果需要上传更大的文件，可以在Program.cs里配置：

  builder.Services.Configure<FormOptions>(options =>
  {
      // 设置最大上传文件大小为100MB
      options.MultipartBodyLengthLimit = 100 * 1024 * 1024;
  });
  

• 文件名处理：如果需要保留用户上传的原文件名，可以把原文件名和生成的S3文件名一起存在数据库里，后续下载时用原文件名返回给用户。
• 权限配置：如果你的S3桶不是公开的，下载时需要确保应用有读取桶内文件的权限，或者可以生成预签名URL来提供临时访问权限。

内容的提问来源于stack exchange，提问作者Alfie K