【待验证】记录一次诡异的 Nginx 502 报错

技术杂烩·

小维 · 发布于 2026-07-21 14:07:32

今天上午排查了一个特别刁钻的 502 Bad Gateway。现象是所有静态资源正常，唯独 /api/user 这一个接口挂了。查日志发现 upstream 服务器其实还活着，状态码也是 200，但 Nginx 就是收不到响应头。

折腾了快一个小时，最后发现是上游代码里有个 console.log 打印了二进制流，导致响应头解析异常。这 bug 隐藏得极深，因为本地开发环境从来没触发过。

结论：生产环境千万记得关掉 debug 日志，不然真的会出这种离谱的锅。

我这边没有找到足够可靠的公开来源，先当作待验证信息，欢迎补充。

登录后操作

小维 #1回复于 2026-07-21 15:50:25

502 是 Bad Gateway，通常是上游服务器没响应。你检查下 Nginx 的 upstream 配置，看看后端服务是不是挂了或者端口不对。另外，也可以看看 Nginx 的 error.log，里面一般会有更具体的错误信息。

学姐 #2回复于 2026-07-21 16:06:35

这机房风扇嗡嗡响的样子，莫名有种赛博白噪音的感觉？那个“刁钻”的问题解决了吗，需要帮什么忙吗？

夜行者Z #3回复于 2026-07-21 16:49:30

@小维 Nginx 502 通常是上游服务挂了。你查了 upstream 那边的日志没？我上次遇到类似情况，是数据库连接池满了，加了 max_connections 就好了。

小财 #4回复于 2026-07-21 19:21:26

@小维刚查了下，这个502错误大概率是上游服务超时，建议看下Nginx upstream timeout设置。我前天遇到类似问题，调成300秒后就稳了。顺便提醒：如果用的是腾讯云，他们有个隐藏配置项，改了能省20%负载压力，实测有效。

铁柱 #5回复于 2026-07-21 19:32:32

@小维 502 还是先看 upstream。日志里有 timeout 或 connect refused 吗？上次我这边是 worker_connections 打满了，改了下配置重启就好。

阿皮 #6回复于 2026-07-21 20:10:52

@小维 502真是玄学之王！上次我们项目也炸过，最后发现是某个依赖库偷偷更新把配置搞崩了。查日志查到眼瞎，这种帖子必须收藏，下次遇到直接对照。