在API Gateway中处理Lambda返回的image/jpeg响应问题求助

核心问题原因 #

API Gateway启用指定二进制媒体类型时，必须同时满足两个条件才会按二进制格式处理响应：

1. 客户端请求头的Accept包含该媒体类型（如image/jpeg）
2. Lambda返回的响应头Content-Type与配置的二进制类型严格匹配

当你设置*/*时，所有请求都会触发二进制处理，所以图片能正常显示，但会导致JSON响应也被转成二进制；而设置image/jpeg时，要么是浏览器请求的Accept头没匹配上，要么是Lambda的响应格式有问题，导致API Gateway不触发二进制解析。

具体修复步骤 #

1. 修正Lambda代理模式的响应格式 #

Lambda返回的结构必须包含以下关键字段，尤其是isBase64Encoded要设为true，Content-Type严格写image/jpeg：

// Node.js示例响应结构
{
  "isBase64Encoded": true,
  "statusCode": 200,
  "headers": {
    "Content-Type": "image/jpeg",
    "Content-Length": "12345" // 可选，填图片实际字节数更稳妥
  },
  "body": "iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAMAAAAoLQ9T..." // 纯Base64字符串，无换行空格
}

注意：body必须是未经格式化的Base64编码内容，不能有任何额外字符。

2. 正确配置并部署API Gateway二进制类型 #

• 进入API Gateway控制台，找到目标API，切换到Settings页面
• 在Binary Media Types中添加image/jpeg，点击保存后，必须重新部署API到对应的阶段（这一步90%的人会忘，不部署等于白配置）

3. 验证浏览器请求的Accept头 #

浏览器直接访问图片URL时，默认Accept头一般是image/webp,image/apng,image/svg+xml,image/*,*/*;q=0.8，其中包含image/*，理论上能匹配image/jpeg。可以通过浏览器开发者工具的Network面板查看请求头，确认Accept是否包含image/jpeg或image/*。如果没有，可能是缓存问题，Ctrl+F5强制刷新清除缓存再试。

4. 区分JSON与图片响应的优化方案 #

如果你的API同时需要返回JSON和图片，别用全局二进制类型配置，换两种方式：

• 给图片请求单独设置路径（比如/api/get-image），在该路径的集成响应中单独配置image/jpeg为二进制类型
• 让Lambda根据请求动态返回响应：如果是图片请求，设置isBase64Encoded: true和Content-Type: image/jpeg；如果是JSON请求，设置isBase64Encoded: false和Content-Type: application/json，API Gateway会自动根据响应头判断处理方式（前提是全局配置了image/jpeg）

常见踩坑点 #

• 未重新部署API：添加二进制类型后必须部署到阶段才会生效
• isBase64Encoded设为false：这会让API Gateway把Base64字符串当文本返回，浏览器无法解析成图片
• Content-Type拼写错误：比如写成image/jpg而非image/jpeg，导致和配置的二进制类型不匹配

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