求助：通过API Gateway上传至S3的图片无法正常显示及打开

针对你遇到的通过API Gateway上传到S3的图片无法打开的问题，结合直接上传S3正常的现象，重点排查以下几个环节：

• 开启API Gateway二进制媒体类型支持
  API Gateway默认会把非文本类型的请求转成base64编码，如果没有配置对应的二进制媒体类型，可能导致图片数据被错误处理。进入API Gateway控制台，找到你的API，在「设置」页面的「二进制媒体类型」中添加image/jpeg和multipart/form-data，然后重新部署API。

• 检查Lambda（若使用）的二进制数据处理逻辑
  如果教程中用Lambda作为中转层，确保Lambda正确处理二进制流：

  • 上传S3时，不要将图片数据当成UTF-8文本读取，直接传递原始二进制内容；
  • 如果Lambda需要返回数据到API Gateway，需将响应的isBase64Encoded设为true；
  • 示例Node.js代码片段：

    // 正确处理表单文件并上传S3
    const fileContent = Buffer.from(event.body, 'base64');
    const params = {
      Bucket: 'your-bucket-name',
      Key: 'myfile.jpeg',
      Body: fileContent,
      ContentType: 'image/jpeg'
    };
    s3.upload(params, (err, data) => { /* ... */ });
    

• 验证S3对象元数据
  登录S3控制台查看损坏图片的元数据：

  • 确认Content-Type是否为image/jpeg，如果是text/plain等错误类型，预览工具会无法识别；
  • 检查是否存在错误的Content-Encoding配置，比如不必要的gzip压缩，导致文件解压失败。
    上传时需明确指定ContentType参数，确保元数据正确。

• 核对Postman请求配置
  确认Postman的POST请求Body设置为form-data，文件字段的类型选择「File」而非「Text」；同时检查请求头的Content-Type是否为multipart/form-data（Postman会自动生成，无需手动设置）。

• 对比文件字节一致性
  查看S3中直接上传和API上传的图片文件大小，若不一致说明传输过程中数据丢失或篡改。可以用十六进制编辑器对比文件头部，JPEG文件的头部应为FF D8 FF，若损坏文件头部不符，说明编码环节出现问题。

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