使用.NET C#上传含[]的文件至IBM Cloud Object Storage失败的问题咨询

原因 #

IBM Cloud Object Storage (COS) 虽然兼容S3 API，但在对象键（Object Key）的特殊字符处理上比原生AWS S3更严格。方括号[和]属于COS要求必须URL编码的特殊字符，而你使用的旧版AWS S3 SDK（3.3.18.2）默认不会对这类字符进行编码，导致COS服务器收到无效的请求参数，返回400 Bad Request错误。原生AWS S3会自动兼容这类未编码的特殊字符，所以在S3或其他宽松的兼容服务中没有问题。

解决方案 #

你可以通过以下几种方式解决这个问题：

1. 手动编码对象键（最直接的修复方式）

放弃使用UploadDirectory批量上传，改为遍历目录文件，手动对文件名中的特殊字符进行URL编码后再上传。这样能精准控制对象键的格式，适配COS的要求：

TransferUtility Utl = new TransferUtility(objClient);
string bucketName = "Correct Bucket name";
string rootDirectory = @"C:\testd1\testd2";
string keyPrefix = "Correct prefix";

var directoryInfo = new DirectoryInfo(rootDirectory);
// 获取所有子目录下的文件
var allFiles = directoryInfo.GetFiles("*.*", SearchOption.AllDirectories);

foreach (var file in allFiles)
{
    // 计算文件相对于根目录的路径
    string relativePath = file.FullName.Substring(rootDirectory.Length + 1);
    // 对路径中的特殊字符进行URL编码，但保留路径分隔符"/"
    string encodedRelativePath = Uri.EscapeDataString(relativePath).Replace("%2F", "/");
    // 拼接最终的对象键
    string objectKey = $"{keyPrefix}/{encodedRelativePath}";

    var uploadRequest = new TransferUtilityUploadRequest
    {
        BucketName = bucketName,
        FilePath = file.FullName,
        Key = objectKey
    };

    Utl.Upload(uploadRequest);
}

2. 升级AWS SDK版本

你当前使用的SDK版本（AWSSDK.S3 3.3.18.2）比较老旧，后续版本的AWS SDK针对S3兼容存储做了更多适配优化，可能已经默认处理了这类特殊字符的编码问题。建议升级到最新的稳定版AWSSDK.S3（比如3.7.x及以上版本），再尝试使用UploadDirectory方法，看是否能自动解决问题。

3. 验证编码后的对象访问

上传成功后，若需要下载文件，记得对对象键进行URL解码，还原原始文件名：

string decodedFileName = Uri.UnescapeDataString(encodedFileName);

内容的提问来源于stack exchange，提问作者Operating Product Section