C#上传文件到S3 C#如何通过AWS SDK将文件存入S3存储桶-C#.Net教程-PHP中文网

最直接的本地文件上传方式是AwsS3Client.PutObjectAsync，适用于≤100MB文件；大文件需用TransferUtility.UploadAsync分块上传；务必配置正确IAM权限（含s3:ListBucket）并准确设置ContentType与ContentLength。

c#上传文件到s3 c#如何通过aws sdk将文件存入s3存储桶

用 `AwsS3Client.PutObjectAsync` 上传本地文件最直接

只要已配置好 AWS 凭据（如 ~/.aws/credentials 或环境变量），且目标存储桶存在、有写权限，PutObjectAsync 就是最轻量的上传方式。它适合小到中等尺寸文件（建议 ≤100MB），不需分片或断点续传。

关键点：

BucketName 必须全小写、符合 DNS 命名规则（不能含下划线、大写字母）
Key 是 S3 中的对象路径，支持子目录形式（如 "uploads/photo.jpg"），但不是真实文件夹
务必设置 ContentType，否则 S3 默认为 binary/octet-stream，浏览器可能无法正确打开图片/PDF
上传大文件时会阻塞线程，建议用 await 配合 CancellationToken

var client = new AmazonS3Client(RegionEndpoint.USEast1);
await client.PutObjectAsync(new PutObjectRequest
{
    BucketName = "my-bucket",
    Key = "docs/report.pdf",
    FilePath = @"C:\temp\report.pdf",
    ContentType = "application/pdf"
});

大文件（>100MB）必须用 `TransferUtility.UploadAsync`

PutObjectAsync 把整个文件读入内存再发请求，超大文件容易 OOM 或超时。TransferUtility 自动分块、并发上传、重试失败块，是官方推荐的大文件方案。

注意：

需要显式引用 AWS.Extensions.S3.Transfer NuGet 包（新版 SDK 中已拆出）
默认并发数是 5，可通过 TransferUtilityConfig 调整，但过高可能触发 S3 请求限频
不支持直接传 Stream，必须是磁盘路径或 MemoryStream（后者仍占内存）
上传进度回调需通过 UploadProgressEvent 订阅，不是返回值里带

var config = new TransferUtilityConfig { ConcurrentServiceRequests = 3 };
var utility = new TransferUtility(new AmazonS3Client(RegionEndpoint.USEast1), config);

var fileTransfer = utility.UploadAsync(@"C:\big\video.mp4", "my-bucket", "videos/2024.mp4");
fileTransfer.UploadProgressEvent += (sender, e) =>
    Console.WriteLine($"Uploaded {e.TransferredBytes}/{e.TotalBytes}");
await fileTransfer;

上传前必须检查存储桶策略和 IAM 权限

即使代码完全正确，上传失败大概率是权限问题。常见错误信息如：Amazon.S3.AmazonS3Exception: Access Denied 或 NotFound（其实是没权限查桶是否存在）。

"避开 C# 常见错误——空陷阱、异步陷阱、LINQ 陷阱及资源泄漏。"

下载

最小必要权限示例（IAM Policy）：

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": ["s3:PutObject"],
      "Resource": "arn:aws:s3:::my-bucket/*"
    },
    {
      "Effect": "Allow",
      "Action": ["s3:ListBucket"],
      "Resource": "arn:aws:s3:::my-bucket"
    }
  ]
}

别漏掉 s3:ListBucket —— TransferUtility 初始化时会先检查桶是否存在，没这个权限就直接抛异常。

流式上传（如从 HTTP 请求体直传）要用 `PutObjectAsync` + `Stream`

如果文件来自 API 请求体、数据库 BLOB 或内存生成，不想落地磁盘，就得传 Stream。这时不能用 FilePath，必须手动设 InputStream 和 ContentLength。

注意：

ContentLength 必须准确，S3 不接受 chunked 编码；若 Stream 不支持 Length（如 Request.Body），需先缓冲或计算长度
确保 Stream 未被提前读取过（Position=0），否则上传空内容
不要在上传后立即 Dispose Stream，SDK 内部会处理

using var stream = new MemoryStream(data);
await client.PutObjectAsync(new PutObjectRequest
{
    BucketName = "my-bucket",
    Key = "tmp/data.json",
    InputStream = stream,
    ContentLength = stream.Length,
    ContentType = "application/json"
});

实际项目里最容易卡住的，是权限配置和 ContentLength 漏设 —— 尤其流式场景下，错误提示不明确，得盯住 WireShark 或启用 SDK 日志才能定位。