如何在AWS API Gateway中传递Content-Type并确保响应头正确？

我之前也碰到过一模一样的问题！控制台测试显示正常，但浏览器访问时Content-Type就变成了application/json，核心原因是API Gateway默认会把响应按JSON处理，得手动配置响应头的映射和类型匹配，下面是具体解决步骤：

1. 配置「方法响应」的允许头 #

• 进入API Gateway控制台，找到对应的API和目标资源方法（比如你的GET方法）
• 切换到「方法响应」标签页，找到200状态码的「HTTP响应头」区域
• 添加Content-Type这个头，确保它被列为允许返回给客户端的响应头

2. 配置「集成响应」的头映射（关键步骤） #

API Gateway需要明确知道把后端返回的头映射到方法响应的对应字段：

• 切换到「集成响应」标签页，选中对应的200状态码
• 在「头映射」区域点击「添加头」，输入Content-Type
• 映射值填写integration.response.header.Content-Type，这会直接把后端服务返回的Content-Type头原样传递到前端
• 务必把「内容处理」选项设置为**「通过（Passthrough）」**，如果选了「转换为JSON」，API Gateway会强制把响应转成JSON格式，直接覆盖Content-Type

3. 重新部署API #

所有配置修改后，必须重新部署你的API到对应阶段（比如prod或dev），否则修改不会生效。部署完成后再用浏览器访问端点，应该就能看到正确的image/png Content-Type了。

额外排查点 #

如果还是没解决，可以检查：

• 确认后端服务确实返回了Content-Type: image/png头（你控制台测试日志已经显示了，这一步大概率没问题，但可以再核对）
• 开启二进制支持：如果你的图片是二进制数据，需要在API的「设置」标签页里，把image/png添加到「二进制媒体类型」列表，保存后重新部署API

按这些步骤操作后，浏览器访问的响应头应该就能和控制台测试的结果一致了。

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