OpenResty 502 Bad Gateway

2026-08-07 15

502 含义:OpenResty (Nginx) 作为反向代理,向上游后端服务请求时,后端没返回有效响应,返回无效 / 断开,就报 502。

常见原因 & 排查步骤

1. 上游后端服务挂了(最高频)

  • 代理配置示例
nginx
proxy_pass http://127.0.0.1:8080; 
  • 检查:curl 127.0.0.1:8080,看能不能通;端口进程是否存活
  • 现象:后端程序崩溃、没启动、端口监听错误

2. 后端连接数满、卡死

后端服务处理不过来,拒绝新连接,OpenResty 拿到失败,抛出 502。

3. 超时配置过小,后端处理慢

nginx
proxy_connect_timeout 3s; proxy_read_timeout 5s; proxy_send_timeout 5s; 
后端接口耗时大于上面超时时间,直接 502。
调大示例:
nginx
proxy_connect_timeout 10s; proxy_read_timeout 60s; proxy_send_timeout 60s;