Nginx 因后端重复发送 Transfer-Encoding 等响应头触发 502 错误，根源是 HTTP/1.1 协议协商冲突；需通过日志定位重复 header，用 proxy_hide_header 移除冗余头，并修正后端主动设置传输编码的行为。
这个问题核心在于 Nginx 收到了后端重复发送的 HTTP 响应头，最典型的是 Transfer-Encoding: chunked，本质是 HTTP/1.1 协议协商不一致导致的冲突。Nginx 作为代理，在启用 HTTP/1.1 后会自行管理分块传输，若后端又主动写入相同 header，就会触发 “duplicate header” 报错并返回 502。
确认重复 header 的具体类型和来源
别跳过日志分析——错误信息里藏着关键线索：
- 查
/var/log/nginx/error.log，完整错误行类似：upstream sent duplicate header line: "Transfer-Encoding: chunked", previous value: "Transfer-Encoding: chunked"
说明后端两次设置了同一 header - 用
curl -v http://your-domain/api抓原始响应头，确认是否真有重复的Transfer-Encoding、Connection或Content-Length - 检查后端框架行为：Spring Boot 默认可能自动加
Transfer-Encoding；Node.js 的 Express 若手动调用res.write()+res.end()又未禁用默认分块，也可能叠加
在 Nginx 配置中规避协议冲突
目标不是让 Nginx 接受非法 header，而是让它“忽略”或“覆盖”后端的冗余声明：
- 强制使用 HTTP/1.1 并清空 Connection 头：
proxy_http_version 1.1;<br>proxy_set_header Connection "";
- 显式移除问题 header（推荐加在
location块内）：proxy_hide_header Transfer-Encoding;<br>proxy_hide_header Content-Length;
注意：proxy_hide_header只影响发给客户端的响应，不改变 Nginx 内部处理逻辑，但能防止 header 冲突被暴露 - 若后端是 Java/Spring，还需确认是否启用了
ServerHttpAsyncResponse或自定义 Filter 主动设置Transfer-Encoding，这类代码要删掉
后端侧配合修正（治本）
Nginx 层面只是拦截，真正要稳定，得让后端按 HTTP 规范输出：
- 禁用后端自动添加
Transfer-Encoding：Spring Boot 中设server.tomcat.use-relative-redirects=false并检查自定义 ResponseWriter；Express 中避免在res.writeHead()后再手动 write header - 统一由 Nginx 控制分块：后端响应保持
Content-Length明确或留空，不要干预传输编码方式 - 升级 Nginx 版本需同步验证后端兼容性：1.21+ 对 header 校验更严格，1.23.2 等版本已默认拒绝重复 header，不能依赖旧版“容忍”行为
协议冲突不是配置调大就能绕开的问题，关键是前后端在 HTTP/1.1 下职责分明——Nginx 负责代理与传输，后端只管生成语义正确的响应体和必要 header。
