用AwsSdk连S3兼容存储需显式设Endpoint、ForcePathStyle=true、BasicAWSCredentials；Stream须Position=0且可读；ListObjectsV2需分页处理；大文件上传要自定义HttpClient超时；Checksum/MD5需按服务动态配置。
用 AwsSdk 连 S3 兼容存储，关键在 endpoint 和认证方式
绝大多数 S3 兼容服务（如 MinIO、Cloudflare R2、腾讯云 COS、阿里云 OSS）不走 AWS 官方 endpoint，也不强制用 IAM 角色，而是靠 Endpoint + ForcePathStyle + 自定义 Credentials 驱动。直接套用 AWS 示例代码必报 Unable to validate the specified S3 URI 或 403 Forbidden。
- 必须显式设置
Endpoint（例如"https://play.min.io"），不能留空或依赖默认值 -
ForcePathStyle = true是硬性要求：S3 兼容服务大多不支持 virtual-hosted-style（bucket.s3.region.amazonaws.com），只认endpoint/bucket/key - 避免用
Amazon.Runtime.CredentialManagement.CredentialProfileStoreChain—— 它会尝试读取 AWS CLI 配置，而你的密钥通常来自控制台或环境变量，直接用BasicAWSCredentials更可控 - Region 可填任意非空字符串（如
"us-east-1"），多数兼容服务不校验它，但 SDK 要求非 null
PutObjectAsync 上传失败？检查 ContentLength 和 Stream 位置
常见现象是上传成功但文件为空，或抛出 System.ArgumentException: Stream was not readable。根本原因不是权限或网络，而是 SDK 对 Stream 的契约比直觉更严格。
- 传入的
Stream必须支持CanRead == true且Position == 0—— 从文件读取后没stream.Seek(0, SeekOrigin.Begin)就上传，会静默写入 0 字节 - 如果手动构造
MemoryStream，务必在构造后调用.Position = 0；若用FileStream，打开时加FileShare.Read，否则并发读可能锁死 - 别依赖
ContentLength自动推断：SDK 在启用ForcePathStyle时可能无法正确计算，显式设PutObjectRequest.ServerSideEncryptionMethod = ServerSideEncryptionMethod.None并传request.ContentLength = stream.Length
列出/删除多个对象时，ListObjectsV2Async 分页逻辑不能省
S3 兼容服务基本都遵循 AWS 的 1000 条/次限制，但很多人写 listResponse.S3Objects 就以为拿全了，结果删漏、同步不全。
-
ListObjectsV2Response.IsTruncated为true表示还有数据，必须循环调用，用listResponse.NextContinuationToken填到下一次请求的ContinuationToken - 不要用
ListObjectsAsync（v1 接口）：部分兼容服务（如早期 R2）已弃用 v1，返回空列表也不报错 - 批量删除用
DeleteObjectsAsync，但注意它最多一次删 1000 个 key —— 超过要拆成多批，且每批 key 列表不能含重复项，否则整批失败
MinIO / R2 等本地或边缘存储，HttpClient 默认超时经常不够用
上传大文件（>100MB）或网络不稳定时，TaskCanceledException 频发，错误信息里常带 Operation canceled，实际是 SDK 底层 HttpClient 的 Timeout（默认 100 秒）被触发。
- 必须自定义
HttpClient并注入：创建new HttpClient(new HttpClientHandler()) { Timeout = TimeSpan.FromMinutes(10) }，再传给AmazonS3Config.HttpClient - 别改
AmazonS3Config.Timeout—— 它只影响部分元数据请求，不影响主体上传流 - 如果用 .NET 6+，注意
HttpClient实例应复用（比如注册为 Singleton），否则高频上传会耗尽 socket
真正麻烦的是跨服务兼容性：MinIO 默认接受 Content-MD5，R2 拒绝它，COS 要求它 —— 同一套代码跑不同后端时，PutObjectRequest 的 ChecksumAlgorithm 和 ContentMD5 得按服务动态开关，这个细节几乎没人提，但上线后第一个坑就是它。
