Java代码上传图片至AWS加密S3后文件损坏无法正常打开如何解决

• 上传时未显式设置正确的Content-Type元数据：Java代码上传S3时如果未指定MIME类型，SDK会默认设置为application/octet-stream，部分解析工具会按照二进制流而非图片格式处理，导致识别失败。
• API Gateway二进制配置不完整：仅开启二进制支持开关未添加对应的图片MIME类型（如image/jpeg、image/png），或者修改配置后未重新部署API，导致返回的图片内容被错误转码为文本格式。
• 上传逻辑存在多余编码：Java代码将图片二进制内容提前转换为Base64字符串后上传到S3，存储的实际是文本内容而非原始图片字节，下载后无法被图片解析器识别。
• 下载逻辑错误：接收API Gateway返回的内容时，以字符串形式解析并做了字符集转码，破坏了原始二进制字节结构，写入本地后的文件为损坏的字节内容。
• KMS解密权限异常：使用SSE-KMS加密的存储桶，若API Gateway或下载方没有对应KMS密钥的kms:Decrypt权限，会返回错误文本内容，写入本地后无法被识别为图片。

• 修正S3上传时的元数据配置：Java上传代码中显式设置和图片格式匹配的Content-Type，示例代码如下：

// AWS SDK v1 示例
ObjectMetadata meta = new ObjectMetadata();
meta.setContentType("image/jpeg"); // 根据实际图片格式调整
PutObjectRequest putRequest = new PutObjectRequest("bucket-name", "object-key", fileInputStream, meta);
s3Client.putObject(putRequest);

• 补全API Gateway二进制配置：进入API Gateway控制台对应API的「设置」页面，在「二进制媒体类型」列表中添加需要支持的图片类型，可直接填写image/*覆盖所有图片格式，修改配置后必须重新部署API才能生效。
• 修正上传逻辑：直接传入图片原始字节流上传，不要提前做Base64编码。使用AWS SDK时优先调用RequestBody.fromFile()、RequestBody.fromBytes()等原生方法传入文件内容。
• 修正下载逻辑：接收API返回内容时直接读取二进制字节流，写入本地文件时不要做字符编码转换，直接写入原始字节即可。
• 校验加密权限：如果使用SSE-KMS加密，确保API Gateway的执行角色、下载操作的执行身份有对应KMS密钥的kms:Decrypt权限，避免错误文本被当做图片内容存储。

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