使用OssClient上传文件前须正确配置AccessKey与Endpoint，Endpoint需匹配Bucket区域，AccessKey应使用子账号最小权限；CosXmlClient初始化需区分长期密钥与STS临时密钥场景，大文件须分片上传，删除操作需注意分页与批量限制。
用 OssClient 上传文件前必须配对 AccessKey 和 Endpoint
阿里云 OSS 不是直连就能传的，OssClient 初始化时如果 Endpoint 写错区域（比如杭州 bucket 用了北京 endpoint），会直接抛 InvalidEndpointException；AccessKey ID/Secret 写反、权限不足或过期，则报 InvalidAccessKeyId 或 AccessDenied。常见错误是把内网 endpoint 当公网用（如 oss-cn-hangzhou-internal.aliyuncs.com），结果本地调试失败但服务器上能通——别猜，先查控制台 bucket 的「基本信息」页，复制「外网 Endpoint」。
实操建议：
- 用
OssClient构造时显式传入Region（如OssRegion.CN_HANGZHOU）比硬写 endpoint 更安全 - AccessKey 务必用子账号 + 最小权限策略（只给
oss:PutObject和oss:GetObject），别用主账号 AK - 开发环境用
appsettings.json分离配置："Oss": { "Endpoint": "...", "AccessKeyId": "...", "AccessKeySecret": "...", "BucketName": "..." }
CosXmlClient 初始化要区分普通上传和临时密钥场景
腾讯云 COS 的 CosXmlClient 默认走长期密钥，但如果用 STS 临时凭证（比如前端直传后端返回 token），就得换构造方式：不能只传 SecretId/SecretKey，得用 CosXmlServerCredentialProvider 包一层，否则会报 SignatureDoesNotMatch。临时密钥有效期短，且 Token 字段必须非空，漏传或为空字符串都会 403。
实操建议：
- 长期密钥初始化：
new CosXmlClient(new CosXmlConfig.Builder().IsHttps(true).Setup()...) - 临时密钥初始化：
new CosXmlClient(new CosXmlConfig.Builder()..., new CosXmlServerCredentialProvider(secretId, secretKey, token)) - 上传前务必调用
client.GetAuthorization()测试凭证有效性，避免上传中途失败
大文件分片上传别硬扛 PutObject，用 InitiateMultipartUpload + UploadPart
单次 PutObject 上传超过 100MB 就容易超时或内存溢出，尤其在 .NET Core 6+ 默认 HttpClient 超时 100 秒的情况下。OSS 和 COS 都要求 >100MB 文件走分片（Multipart），但两者的触发逻辑不同：OSS 的 OssClient 有 UploadFile 封装自动分片，COS 的 CosXmlClient 却要手动调 InitiateMultipartUpload → 分批 UploadPart → 最后 CompleteMultipartUpload。
实操建议：
- OSS 直接用
client.UploadFile(bucket, objectKey, localFilePath)，它内部已处理断点续传和并发上传 - COS 必须自己管理 uploadId 和 partETag 列表，
CompleteMultipartUpload时传的partNumber必须严格递增，否则报InvalidPart - 分片大小建议设为 5–10MB（
partSize），太小增加请求次数，太大降低并发收益
删除和列举操作要注意分页和前缀匹配的写法差异
OSS 的 ListObjects 默认只返回 100 条，且不支持 SQL 式模糊查询；COS 的 GetBucket 同样分页，但参数名是 max-keys 而不是 MaxKeys。更关键的是「按前缀删」：OSS 要先 ListObjects 拿 key 列表再循环 DeleteObject，COS 则提供批量接口 DeleteMultiObject，但一次最多删 1000 个，超量得拆包。
实操建议：
- OSS 批量删示例：
var result = client.ListObjects(bucket, prefix: "logs/2024/"); foreach (var obj in result.ObjectSummaries) client.DeleteObject(bucket, obj.Key); - COS 批量删前先分组：
var keys = result.Contents.Select(x => new ObjectIdentifier { Key = x.Key }).Chunk(1000); - 两者都建议加
prefix参数缩小范围，否则全量 list 可能超时或 OOM
跨云迁移或双写时，别假设两个 SDK 行为一致——OSS 的 CopyObject 支持跨 bucket，COS 的 CopyObject 默认同 region，跨 region 得走 PostObject 拉取再上传。细节藏在文档犄角，不踩一遍真记不住。
