MinIO 必须使用官方 MinioClient 而非 AmazonS3Client，因签名逻辑（s3v4 endpoint 行为）、预签名 URL 生成及分片上传机制不兼容，否则触发 403/400/OOM；初始化需单例复用、强制 HTTPS 验证、正确配置 WithSSL(true)。
别用 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://...时，否则静默失败
推荐初始化写法：
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);
上传进度和断点续传得自己兜底
MinioClient 没有 ProgressChanged 事件，也不提供回调参数。进度监控和断点续传都得靠你自己：
- 进度：读取
Stream时包装一层带计数的ProgressStream，每读一段就更新 UI 或日志 - 断点续传：必须持久化记录
uploadId、每个已上传分片的partNumber和返回的Etag，重试时跳过已成功部分 - 失败后清理：调
AbortMultipartUploadAsync清理残留分片，否则占空间还影响后续同名文件上传
最容易被忽略的是：UploadPartAsync 成功只代表服务端接收完成，不代表最终写入磁盘。如果 CompleteMultipartUploadAsync 失败，前面所有分片仍需手动清理，否则下次上传同名对象会撞 uploadId 冲突。
