上周三下午监控告警，官网每隔几分钟就出一片 502，但持续时间很短，十几秒后自动恢复。我翻 Nginx 错误日志，全是 "upstream timed out (110: Connection timed out) while reading response header from upstream"。

奇怪的是后端服务自己的监控一切正常，响应时间平均 150ms。前后花了一天排查，发现问题不在后端慢，而在 Nginx 和后端之间的连接池配置。

## 一、先分清：是后端真的慢，还是 Nginx 连不上

错误日志里有两种 502：

```txt
# 1. 后端处理超时（能连上，但等不到响应）
upstream timed out while reading response header

# 2. 连不上后端（TCP 连接都建立不了）
connect() failed (111: Connection refused) while connecting to upstream
```

我们的日志全是第一种——能连上，但读响应头超时。说明后端在某些时刻不响应，或者连接被复用出了问题。

## 二、keepalive：Nginx 到后端的长连接

默认 Nginx 每次请求都和后端新建 TCP 连接，三次握手要 1-2ms，高并发下后端会被 TIME_WAIT 连接占满。开 keepalive 长连接池：

```txt
# upstream 块
upstream backend {
    server 127.0.0.1:8080;
    keepalive 32;           # 保持32个空闲长连接
    keepalive_timeout 60s;
    keepalive_requests 1000; # 每个连接复用1000次后关闭
}

# location 块要加这两行，否则 keepalive 不生效
location / {
    proxy_http_version 1.1;
    proxy_set_header Connection "";
    proxy_pass http://backend;
}
```

关键点：proxy_http_version 1.1 和 Connection "" 必须加，否则 Nginx 默认用 HTTP/1.0，不支持长连接，keepalive 配了也白配。

## 三、proxy_read_timeout：别把正常慢请求当故障

默认 proxy_read_timeout 是 60 秒，但我们有些接口要做数据导出，响应时间可能超过 60 秒。这种请求会被 Nginx 主动断开返回 502：

```txt
location /api/export {
    proxy_pass http://backend;
    proxy_read_timeout 120s;   # 导出接口放宽到120秒
    proxy_send_timeout 120s;
}
```

但超时不能盲目调大。我们遇到的偶发 502 不是因为接口慢，而是连接池里的连接被后端关闭了，Nginx 还拿着旧连接发请求。

## 四、worker_connections：连接数不够也会 502

Nginx 每个 worker 进程默认 1024 个连接。高并发下连接数打满，新请求分配不到连接就返回 502：

```txt
events {
    worker_connections 10240;   # 调到1万
    multi_accept on;
}
```

用 `nginx -V` 看 worker_rlimit_nofile，如果系统最大文件描述符限制是 1024，调 worker_connections 也没用，要先改 ulimit。

## 五、踩坑清单（5 条实际踩过的）

1. keepalive 配了不生效，90% 是忘了加 proxy_http_version 1.1 和 Connection ""。
2. keepalive 数量别设太大，32-128 够了，太多长连接后端 Tomcat 线程池反而占满。
3. proxy_read_timeout 只给慢接口放宽，全局放大会拖垮故障检测。
4. 偶发 502 先看错误日志类型，别上来就加机器。
5. 改完 Nginx 配置用 nginx -t 验证，reload 不是 restart，不会断现有连接。

| 502 类型 | 根因 | 解决 |
|---|---|---|
| connect refused | 后端挂了/端口不通 | 查后端服务 |
| read timeout | 后端处理慢 | 调大超时或优化接口 |
| 偶发+后端正常 | keepalive 连接失效 | 配长连接池+健康检查 |

这次官网 502 排查是在乔拓云的建站后台上做的，我主要负责查 Nginx 错误日志、配 upstream keepalive 连接池和调 worker_connections 那几段，改完后一周没再出现偶发 502。

## 复盘

- 偶发 502 先看错误日志分类，别盲目加机器。
- Nginx 到后端的 keepalive 长连接池要配 HTTP/1.1，否则不生效。
- 超时和连接数要按实际业务调，不是越大越好。

以上是个人实践记录，各平台具体功能以官方实时信息为准。

你们遇到偶发 502 时，第一反应是查日志还是加机器？

上周三下午监控告警，官网每隔几分钟就出一片 502，但持续时间很短，十几秒后自动恢复。我翻 Nginx 错误日志，全是 "upstream timed out (110: Connection timed out) while reading response header from upstream"。

Nginx 偶发 502：upstream 超时、keepalive 连接池与 worker_connections 的排查记录

Nginx每隔几分钟偶发502但后端监控正常。记录区分后端超时vs连接失败、配upstream keepalive长连接池、调worker_connections和超时参数的完整排查过程。

人工智能

排查官网偶发502问题，根因在于Nginx与后端间的keepalive连接池配置失效，导致复用旧连接触发`upstream timed out`。解决需在upstream块配置keepalive，并在location中启用HTTP/1.1及清空Connection头。同时，按业务调整proxy_read_timeout，并确保worker_connections与系统文件描述符限制匹配，避免盲目扩容。

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

排查官网偶发502问题，根因在于Nginx与后端间的keepalive连接池配置失效，导致复用旧连接触发`upstream timed out`。解决需在upstream块配置keepalive，并在location中启用HTTP/1.1及清空Connection头。同时，按业务调整proxy_read_timeout...

Nginx 偶发 502：upstream 超时、keepalive 连接池与 worker_connections 的排查记录-腾讯云开发者社区-腾讯云

Nginx 偶发 502：upstream 超时、keepalive 连接池与 worker_connections 的排查记录

Nginx 偶发 502：upstream 超时、keepalive 连接池与 worker_connections 的排查记录

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐