C#如何使用MinIO_C#兼容S3协议的对象存储文件上传【进阶】-C#.Net教程-PHP中文网

minio 必须使用官方 minioclient 而非 amazons3client，因签名逻辑（s3v4 endpoint 行为）、预签名 url 生成及分片上传机制不兼容，否则触发 403/400/oom；初始化需单例复用、强制 https 验证、正确配置 withssl(true)。

c#如何使用minio_c#兼容s3协议的对象存储文件上传【进阶】

别用 AmazonS3Client 直连 MinIO，签名不兼容、分片上传必炸；必须用官方 MinioClient，且要设对参数，否则 403、400、OOM 都会找上门。

为什么 `AmazonS3Client` 在 MinIO 上跑不通

MinIO 虽然兼容 S3 协议，但签名逻辑（尤其是 s3v4 的 endpoint 行为）和预签名 URL 生成细节与 AWS 实际服务存在差异。直接上 AmazonS3Client 会遇到：

CreateMultipartUpload 返回 403 Forbidden —— 因为 SDK 默认发的是 path-style 请求，而 MinIO 要求 virtual-hosted-style 或显式适配
预签名 URL 访问时提示 InvalidSignatureException —— 签名密钥派生路径不一致
调 PutObjectAsync 传大文件时内存暴涨甚至 OOM —— 它把整个 Stream 缓存进内存再发，没做流式分块

官方 MinioClient（NuGet 包名 Minio，不是 AwsSdk）内置了 MinIO 专属的签名器和 endpoint 处理逻辑，省去手动调 ForcePathStyle 或改 ServiceURL 的麻烦。

`MinioClient` 初始化必须注意的三件事

错一个就可能连不上、权限报错或并发崩掉：

必须单例复用：它线程安全，反复 new MinioClient() 会快速耗尽 socket，触发 SocketException: Too many open files
HTTPS 必须配合法证书：生产环境若用自签或 HTTP，MinioClient 默认拒绝连接（可关但不建议）
构造时不要漏 .WithSSL(true)（或 Secure = true），尤其当 endpoint 是 https://... 时，否则静默失败

推荐初始化写法：

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

下载

var client = new MinioClient()
    .WithEndpoint("https://minio.example.com:9000")
    .WithCredentials("YOUR-ACCESS-KEY", "YOUR-SECRET-KEY")
    .WithSSL(true)
    .Build();

大文件上传必须走标准 multipart 流程

PutObjectAsync 适合小文件（

分片大小不能小于 5 * 1024 * 1024（5MB）—— 这是 S3 协议硬限制，UploadPartAsync 报 EntityTooSmall 就是它
partNumber 必须从 1 开始递增整数，传 0 或负数会直接报错：The part number must be an integer between 1 and 10000
总分片数不能超 10000，所以最大支持约 50GB（5MB × 10000）
别用 FileInfo.Length 算分片边界，用 stream.Length 更准，尤其处理加密流或网络流时

关键步骤顺序不能乱：

var uploadId = await client.CreateMultipartUploadAsync(...);
foreach (var part in parts) {
    var etag = await client.UploadPartAsync(..., partNumber: i + 1, ...);
    // 自己存 uploadId + partNumber + etag 到 DB 或本地文件，用于断点续传
}
await client.CompleteMultipartUploadAsync(..., etags);