nginx：提示error： upstream prematurely close connection while reading response head

Posted on Views:

错误信息

upstream prematurely closed connection while reading response header from upstream

是 nginx 作为反向代理时的常见报错，意思是：
Nginx 还没从后端（upstream，比如应用服务器）完整拿到响应头，后端就主动把连接断开了。

常见原因

  1. 后端服务超时/崩溃

    • 后端处理请求耗时太长，超过了 nginx 的 proxy_read_timeout，连接被断掉。
    • 或者应用本身报错退出（进程挂掉、OOM、panic）。

  2. 后端返回的数据超过缓冲区限制

    • Nginx 在等 header，但 upstream 返回了大 header，超过 proxy_buffer_size / proxy_buffers 限制，导致异常。

  3. 后端 keepalive / 连接池问题

    • 后端进程提前关闭了 TCP 连接，nginx 还以为能读数据。
    • 常见于 upstream keepalive 配置和后端（如 gunicorn、tomcat、go 服务）的 keepalive_timeout 不一致。

  4. 后端服务 bug

    • 应用层没写完 header 就关闭了连接，比如写入流时 panic、或者 flush 错误。

  5. 资源瓶颈

    • 后端服务器内存不足，被 OOM killer 干掉。
    • 内核 backlog 队列满（netstat -s | grep listen 可看到）。
    • 或者数据库连接池用尽，导致应用抛异常提前断开。

排查思路

  1. 看后端日志

    • 找对应请求的时间点，确认应用是否报错 / panic / OOM。

  2. 调高 nginx 超时

    1
    2
    3
    4
    proxy_connect_timeout   60s;
    proxy_send_timeout      60s;
    proxy_read_timeout      60s;
    send_timeout            60s;

  3. 调大 header 缓冲区

    1
    2
    3
    proxy_buffer_size       16k;
    proxy_buffers           8 16k;
    proxy_busy_buffers_size 32k;

  4. 检查 keepalive 配置

    • 确认 nginx upstream 的 keepalive 设置与后端 server 的 keepalive_timeout 协调（客户端要大于后端的keepalive_timeout值，防止后端提前关闭http连接）。

  5. 确认后端服务健康

    • 看进程是否被 OOM。
    • 查看连接数（netstat -anp | grep <port>）。
    • 数据库/缓存是否卡住。

  6. 抓包/调试

    • 在 nginx 和 upstream 之间抓包，看看连接谁先断掉。
    • 或用 curl -v 直接请求 upstream，看响应是否完整。

🔥 一句话总结：

这个报错基本都不是 nginx 的锅，而是 后端服务提前断开，要么是超时、要么是异常退出。Nginx 侧可以通过调大 timeout 和 buffer兜底，但核心还是要看 upstream 服务为什么断开。