502错误本质是Nginx作为代理未能从上游获取合法HTTP响应，需结合error.log线索、proxy_pass可达性、协议/端口/监听状态三者一致性及缓冲区与超时配置综合排查。
502 错误本质是 Nginx 作为代理，没能从上游服务拿到合法 HTTP 响应。proxy_pass 配置错误是高频诱因，但不能只盯着这一行改——要结合日志、网络和上游状态交叉验证。
看 error.log 找第一线索
Nginx 错误日志里藏着最直接的故障指向。执行：
tail -n 100 /var/log/nginx/error.log | grep -i "upstream\|502\|connect\|timeout"
重点关注这几类报错：
linux-performance-analyzer
下载
Linux 性能分析与调优专家，覆盖 CPU、内存、磁盘 I/O、网络、内核参数、编译优化、容器/K8s。适用场景：系统卡顿/高负载、内存不足/OOM/Swap 高、CPU 异常/iowait 高。
- connect() failed (111: Connection refused) → 上游服务根本没监听对应端口，或服务未启动
- connect() failed (113: No route to host) → 网络不通，可能是容器网络、防火墙、宿主机路由问题
- upstream timed out → 连上了但没收到响应，大概率是后端卡死、超时设置过短或响应头过大
- upstream sent too big header → 后端返回的 Header 超出 Nginx 默认缓冲区（通常 4K），需调大 proxy_buffer_size
检查 proxy_pass 地址是否真实可达
别只信配置文件里的写法，要手动模拟 Nginx 的视角去连一次：
- 如果 proxy_pass 是 http://localhost:8080，在 Nginx 所在机器上运行：curl -v http://localhost:8080/health —— 注意：容器中 localhost 指向的是容器自身，不是宿主机
- 如果 proxy_pass 是 http://172.18.0.3:3000，先确认该 IP 是否属于当前网络段，再 telnet 或 curl 测试连通性
- 如果 proxy_pass 是 https://api.example.com，必须加 proxy_ssl_server_name on; 和 proxy_ssl_name api.example.com;，否则 SNI 握手失败会静默 502
核对协议、端口与上游监听状态
三个关键点必须严丝合缝：
- proxy_pass 写的是 http，上游就得用 HTTP 协议监听；写 https，上游就得支持 TLS，且证书有效
- proxy_pass 写的端口（如 :8080），上游进程必须真正在该端口上 listen —— 用 ss -tlnp | grep :8080 或 netstat -tuln | grep :8080 确认
- 上游如果是容器，检查它暴露的端口（EXPOSE）和实际映射（-p）是否一致；如果是 systemd 服务，确认它 bind 的是 0.0.0.0 而非 127.0.0.1（后者仅本机可连）
补几个容易忽略的配置细节
这些参数不写进配置，高并发或大响应下极易触发 502：
- 加缓冲区：proxy_buffer_size 128k; proxy_buffers 4 128k; proxy_busy_buffers_size 256k;
- 设合理超时：proxy_connect_timeout 30; proxy_send_timeout 180; proxy_read_timeout 180;
- 关无效重试：proxy_next_upstream error timeout http_500 http_503;（避免把压力反复打到已故障节点）
- HTTPS 代理必加：proxy_ssl_verify off;（测试环境）或配好 CA；proxy_ssl_protocols TLSv1.2 TLSv1.3;
