Android端用aws-android-sdk上传S3时如何保留键中的特殊字符？

我之前也踩过这个坑！当用TransferUtility上传带=、,这类特殊字符的S3对象键时，默认的URL编码逻辑会把这些字符转成编码后的形式，甚至出现双重编码（比如=变成%253D），这显然不是我们想要的效果。下面是我验证过的解决方案：

核心思路：关闭自动URL编码 #

TransferUtility默认会对对象键做URL编码，但我们可以通过自定义S3客户端配置，禁用这个自动编码行为，让S3直接使用我们传入的原始键字符串。

代码实现步骤 #

1. 创建自定义的S3客户端配置，开启disableUrlEncoding：

// 初始化S3客户端配置，禁用自动URL编码
AmazonS3ClientConfig s3Config = new AmazonS3ClientConfig();
s3Config.setDisableUrlEncoding(true);

2. 用这个配置创建AmazonS3客户端：

// 替换成你的凭证提供者（比如CognitoCredentialsProvider）
AWSCredentialsProvider credentialsProvider = new CognitoCredentialsProvider(
        context,
        "YOUR_COGNITO_POOL_ID",
        Regions.US_EAST_1 // 替换成你的区域
);

AmazonS3 s3Client = new AmazonS3Client(credentialsProvider, s3Config);

3. 用自定义的S3客户端构建TransferUtility：

TransferUtility transferUtility = TransferUtility.builder()
        .context(context)
        .s3Client(s3Client)
        .build();

4. 现在再调用upload方法，传入原始键即可：

String key = "year=2018/month=1/versions=1,2/my_file.txt";
TransferObserver observer = transferUtility.upload(
        "your-bucket-name",
        key,
        new File("/path/to/your/file.txt")
);

注意事项 #

• 确保你的对象键符合S3的命名规范：S3允许使用=、,这类字符，但像空格、?、#这类字符虽然也支持，但可能在某些场景下需要额外处理。
• 如果你之前已经上传了编码后的键，要注意区分新旧对象，避免混淆。
• 其他访问方式（比如AWS控制台、其他SDK）都能正常识别带特殊字符的键，不需要额外处理。

内容的提问来源于stack exchange，提问作者Michael