ASP.NET Core 7接口返回TypeError: Decoding Failed问题求助

1. TypeError: Decoding failed的含义 #

是的，这个错误明确表示客户端（Next.js代理及前端）无法正确解码后端返回的响应内容。通常原因是响应标头声明了Content-Encoding=gzip，但实际返回的内容并未被正确压缩，导致客户端按gzip格式解码失败。

2. Content-Encoding=gzip的来源 #

这个标头来自两个核心渠道：

• ASP.NET Core响应压缩中间件：如果项目中配置了AddResponseCompression和UseResponseCompression，当响应内容符合压缩条件（如MIME类型为application/json、内容大小超过阈值）时，中间件会自动压缩内容并添加该标头。
• Azure Web App动态压缩：Azure Web App默认开启动态内容压缩功能，会对符合条件的后端响应进行压缩并添加该标头，即使ASP.NET Core本身未配置压缩。

3. 为什么修改返回方式后错误消失 #

Ok(response)返回的是OkObjectResult，CreatedAtAction返回的是CreatedAtActionResult，两者在ASP.NET Core的响应处理流程上存在差异：

• OkObjectResult的响应路径触发了Azure或ASP.NET Core的压缩逻辑，但压缩过程出现异常——比如序列化后的内容未被正确压缩，但标头已被加上gzip，导致客户端拿到"假压缩"内容，解码失败。
• CreatedAtActionResult的响应因状态码（201）、内容大小/类型不符合压缩触发条件，或处理路径绕过了有问题的压缩逻辑，因此未添加gzip标头，客户端能正常解析原始响应内容。

4. GET接口的问题解决思路 #

直接return products会被ASP.NET Core自动包装为ObjectResult，仍会触发压缩逻辑，所以问题依旧。可从以下方向排查：

• 禁用ASP.NET Core响应压缩：在Program.cs中注释掉AddResponseCompression和UseResponseCompression相关代码，验证是否是ASP.NET Core压缩逻辑导致的问题。
• 关闭Azure Web App动态压缩：登录Azure门户，进入目标Web App→配置→常规设置，找到"动态内容压缩"选项并关闭，避免Azure与ASP.NET Core的压缩逻辑冲突。
• 验证响应真实性：用curl或Postman直接请求接口，确认响应内容是否真的是gzip压缩格式。例如执行：

  curl -H "Accept-Encoding: gzip" -v https://你的接口地址/products
  

  如果返回内容无法用gzip解压，说明压缩流程确实存在异常。
• 检查JSON序列化配置：若项目替换了默认的System.Text.Json为Newtonsoft.Json，部分自定义序列化配置可能与压缩逻辑冲突，尝试恢复默认序列化配置测试。

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