后端服务交互返回502 Bad Gateway错误排查求助

架构信息 #

• CloudFlare(CF)：负责缓存、SSL加密等
• Nginx(NG)：作为反向代理
• Docker：通过DNS解析实现负载均衡
• 应用与服务：webapp、recipes_service、products_service（webapp仅做API调用，已排除在问题范围外）

正常工作场景 #

1. 向CF托管域名发送GET /api/recipes请求，经CF解析、NG代理后，recipes_service返回200 OK及对应数据
2. 向CF托管域名发送GET /api/products请求，经CF解析、NG代理后，products_service返回200 OK及对应数据

异常场景 #

向CF托管域名发送GET /api/recipes/fresh请求，经CF解析、NG代理到recipes_service；recipes_service调用CF托管域名的GET /api/products/fresh/:id接口，经CF解析、NG代理到products_service，products_service返回200 OK及对应数据；但最终recipes_service向客户端返回502 Bad Gateway。

日志信息 #

错误日志（error.logs） #

2024/03/15 18:56:51 [error] 41#41: *211 upstream sent "Content-Length" and "Transfer-Encoding" headers at the same time while reading response header from upstream, client: <ip>, server: api.example.com, request: "GET /api/recipes/fresh HTTP/2.0", upstream: "http://<ip>>:3030/recipes/fresh", host: "api.example.com"

访问日志（access.logs） #

<ip> - - - api.example.com api.example.com to: <ip of products_service>:3020: GET /api/products/fresh HTTP/2.0 200 upstream_response_time 0.135 msec 1710529217.923 request_time 0.135
<ip> - - - api.example.com api.example.com to: <ip of recipes_service>:3030: GET /api/recipes/fresh HTTP/2.0 502 upstream_response_time 0.247 msec 1710529217.933 request_time 0.247

问题根源与修复方案 #

从错误日志可直接定位问题：上游的recipes_service在返回响应时，同时发送了Content-Length和Transfer-Encoding两个HTTP头，这违反了HTTP协议规范——这两个头字段互斥，不能同时存在。Nginx检测到冲突后无法正常处理响应，因此返回502 Bad Gateway。

修复步骤： #

1. 优先修复服务端逻辑：

   • 检查recipes_service的响应处理代码，确保返回结果时只设置Content-Length或Transfer-Encoding中的一个
   • 若使用开发框架，排查框架的自动响应头配置，确认是否有中间件、序列化工具等组件同时添加了这两个头字段

2. 临时规避方案（仅应急使用）：
   在Nginx的反向代理配置中添加指令，强制移除其中一个冲突的头字段，示例如下：

   # 移除Transfer-Encoding头
   proxy_hide_header Transfer-Encoding;
   # 或者移除Content-Length头
   # proxy_hide_header Content-Length;
   

   注意：此方案仅为临时绕过，长期必须修复服务端响应头逻辑，避免潜在兼容性问题。

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