Lambda通过Sharp处理S3图片后，API Gateway下载图片损坏问题

核心原因1：Lambda上传S3时的二进制编码错误 #

Lambda处理Sharp输出的图片Buffer时，若误将二进制数据转为UTF-8字符串再转回Buffer上传，会导致字节丢失，破坏图片结构。比如错误使用buffer.toString('utf8')再Buffer.from(str, 'utf8')的操作，会让图片数据不可逆损坏。

• 解决：直接将Sharp生成的原始Buffer传入S3的putObject方法，跳过不必要的字符串转换。示例代码：

  sharp(inputBuffer)
    .resize(300, 300)
    .toBuffer()
    .then(resizedBuffer => {
      s3.putObject({
        Bucket: 'processed-bucket',
        Key: 'resized-image.jpg',
        Body: resizedBuffer,
        ContentType: 'image/jpeg'
      }).promise();
    });
  

核心原因2：API Gateway未配置二进制媒体类型 #

API Gateway默认会将非文本响应做Base64编码处理，若未配置图片对应的媒体类型，会把二进制图片数据转为Base64字符串返回，导致文件体积增大30%左右，且浏览器无法识别为有效图片。

• 解决：在API Gateway控制台进入目标API的「设置」页，在「二进制媒体类型」中添加image/*（覆盖所有图片格式）或具体类型如image/jpeg、image/png，完成后重新部署API。

核心原因3：S3对象Content-Type元数据缺失 #

Lambda上传图片到S3时，若未指定ContentType参数，S3会默认设置为application/octet-stream。API Gateway返回该对象时，浏览器无法识别为图片格式，导致解析失败。而手动上传时S3会自动识别并设置正确的Content-Type，因此无问题。

• 解决：在S3putObject请求中显式设置ContentType，匹配处理后图片的实际格式（如JPG设为image/jpeg，PNG设为image/png）。

额外排查点：API Gateway与Lambda集成的响应格式 #

若API Gateway直接通过Lambda集成返回图片，需确保Lambda响应满足以下要求：

• 将图片Buffer转为Base64字符串（buffer.toString('base64')）
• 设置isBase64Encoded: true
• 指定正确的Content-Type在响应头中
  示例响应结构：

{
  statusCode: 200,
  headers: {
    'Content-Type': 'image/jpeg'
  },
  isBase64Encoded: true,
  body: resizedBuffer.toString('base64')
}

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