为何API Gateway代理集成的CloudWatch日志响应体无法正常读取

乱码原因 #

这不是刻意加密或哈希处理的结果，本质是API Gateway默认会将二进制格式的响应内容做base64编码后写入CloudWatch日志，而日志控制台不会自动解码这些编码内容，所以显示为乱码。客户端能正常接收响应，是因为API Gateway会自动完成解码后再返回给客户端，这一步无需额外配置。

是否需要请求/响应映射？ #

如果后端返回的是JSON这类文本内容，建议显式配置API Gateway的媒体类型规则，避免日志被编码。不过你是直接代理透传场景，也可以通过简单配置强制日志显示明文，不需要复杂的请求/响应映射。

具体修复方案（CDK实现） #

提供两种可行的配置方式，按需选择：

方案1：配置全局二进制媒体类型 #

在创建RestApi实例时，指定binaryMediaTypes，用*/*匹配所有媒体类型（适合代理场景），让API Gateway根据实际内容类型判断是否按文本处理：

const api = new RestApi(this, 'MyProxyApi', {
  binaryMediaTypes: ['*/*'], // 匹配所有媒体类型
  // 保留你的其他原有配置
});

部署后，API Gateway会根据响应的Content-Type头自动处理，文本类内容的日志会以明文显示。

方案2：强制集成转换为文本 #

直接在HttpIntegration的配置中添加contentHandling参数，强制将所有响应内容转换为文本格式：

defaultIntegration: new HttpIntegration(`${endpoint}/{proxy}`, {
  httpMethod: 'ANY',
  options: {
    requestParameters: {
      ['integration.request.path.proxy']: 'method.request.path.proxy'
    },
    cacheKeyParameters: [
      'method.request.path.proxy'
    ],
    contentHandling: ContentHandling.CONVERT_TO_TEXT // 新增这一行
  }
})

这个方案更直接，适合纯代理透传场景，强制API Gateway将响应体当作文本处理，日志直接显示明文。

验证 #

部署修改后的CDK栈，重新触发请求后查看CloudWatch日志，Endpoint response body before transformations和Method response body after transformations这两类日志就能正常显示明文内容，方便你查看响应体中的错误信息。

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