这种本地正常、部署到AWS就出解码错误的情况，大概率是服务端双重压缩或者配置不匹配导致的，我整理了几个排查和修复方向，你可以逐一尝试：

1. 禁止Lambda自行压缩响应 #

本地环境可能是你的开发服务器（比如Kestrel）自动处理了压缩，但部署到Lambda后，如果代码里还保留了压缩逻辑（比如用了AddResponseCompression中间件，或者手动添加了Content-Encoding头），就会和API Gateway的压缩功能冲突，导致双重压缩，浏览器无法解码。

• 修复方法：
  • 在.NET代码中，判断当前环境是否为Lambda生产环境，禁用响应压缩中间件：

    var builder = WebApplication.CreateBuilder(args);
    if (!builder.Environment.IsProduction() || !builder.Configuration.GetValue<bool>("IsLambdaEnvironment"))
    {
        builder.Services.AddResponseCompression(options =>
        {
            options.EnableForHttps = true;
            options.MimeTypes = ResponseCompressionDefaults.MimeTypes.Concat(new[] { "application/json" });
        });
    }
    

  • 检查代码中有没有手动设置Content-Encoding头的地方，比如Response.Headers["Content-Encoding"] = "gzip"，这类代码要在Lambda环境下移除。

2. 确认API Gateway压缩的MIME类型覆盖你的响应 #

API Gateway默认只对特定MIME类型（比如text/html、application/json、text/css等）启用压缩，如果你的Lambda返回的是其他类型（比如application/xml、自定义的媒体类型），API Gateway不会自动压缩，反而可能因为头信息不匹配导致错误。

• 修复方法：
  1. 登录AWS控制台，进入API Gateway服务，找到你的API
  2. 点击左侧菜单栏的Settings，找到Content Encoding部分
  3. 在Compressible MIME Types里添加你的响应对应的MIME类型（比如application/xml）
  4. 重新部署API到对应阶段（比如prod）

3. 不要手动设置Content-Length头 #

如果你的Lambda代码手动设置了Content-Length头，这个值是原始未压缩内容的长度，但API Gateway压缩后内容长度会变小，浏览器收到后会因为实际内容长度和头信息不符，触发解码失败。

• 修复方法：
  移除代码中所有手动设置Content-Length的逻辑，让API Gateway自动处理这个头字段。当API Gateway压缩内容时，它会自动更新Content-Length为压缩后的长度。

4. 检查Lambda Proxy集成的响应格式 #

如果你用的是Lambda Proxy集成（这是.NET Lambda的常见配置），确保返回的APIGatewayProxyResponse结构正确：

• IsBase64Encoded必须设为false（除非你返回的是二进制文件，比如图片）
• Body是原始的文本内容（比如JSON字符串），不要做Base64编码

错误示例：

return new APIGatewayProxyResponse
{
    IsBase64Encoded = true,
    Body = Convert.ToBase64String(Encoding.UTF8.GetBytes(jsonString)),
    Headers = new Dictionary<string, string> { { "Content-Type", "application/json" } }
};

正确示例：

return new APIGatewayProxyResponse
{
    IsBase64Encoded = false,
    Body = jsonString,
    Headers = new Dictionary<string, string> { { "Content-Type", "application/json" } }
};

5. 验证API Gateway部署是否生效 #

修改API Gateway的压缩配置后，必须重新部署API才能让配置生效，很多人会忽略这一步。

• 修复方法：
  在API Gateway控制台，点击你的API，然后点击顶部的Deploy API按钮，选择你正在使用的部署阶段（比如prod），确认部署。

6. 用工具排查响应细节 #

可以用curl命令测试，查看响应头和内容是否正常：

curl -H "Accept-Encoding: gzip, br" -v https://your-api-endpoint

• 如果返回的Content-Encoding头是gzip或br，且能正常解压内容，那可能是浏览器缓存问题，清除浏览器缓存再试
• 如果curl也返回解码错误，那说明服务端配置还有问题，回到前面的步骤重新检查

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