502 bad gateway 表示 apache 作为反向代理时未能从后端（如 tomcat、node.js）获得有效响应，需依次检查代理配置、后端服务状态、apache 错误日志及超时参数。
502 bad gateway 通常表示 apache 作为反向代理时，无法从后端服务器（如 tomcat、node.js、php-fpm 等）收到有效响应。排查需围绕“代理链路是否通、后端是否活、通信是否被截断”展开。
检查 Apache 的代理配置是否正确
确认 mod_proxy 及相关模块已启用：
- 运行
a2enmod proxy proxy_http proxy_connect（Debian/Ubuntu）或检查httpd.conf中是否有LoadModule proxy_module modules/mod_proxy.so等加载行 -
ProxyPass和ProxyPassReverse的路径与后端服务地址必须匹配，例如：ProxyPass / http://127.0.0.1:8080/ProxyPassReverse / http://127.0.0.1:8080/ - 避免尾部斜杠不一致（如
ProxyPass /app http://localhost:3000与ProxyPass /app http://localhost:3000/行为不同）
验证后端服务是否正常响应
绕过 Apache 直接测试后端：
- 用
curl -v http://127.0.0.1:8080/health或访问其首页，确认返回 HTTP 200 且无超时 - 检查后端是否绑定在正确的 IP 和端口（如是否只监听
127.0.0.1而非0.0.0.0，或端口被防火墙拦截） - 查看后端日志（如 Tomcat 的
catalina.out、Node.js 控制台输出），确认有无启动失败、崩溃或拒绝连接记录
查看 Apache 错误日志定位具体原因
502 错误在 Apache 日志中通常附带更明确的线索：
Apache Superset Dashboard and SQL Exploration Skill
下载
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
- 打开
ErrorLog配置项指定的日志文件（常见路径：/var/log/apache2/error.log或/var/log/httpd/error_log） - 搜索关键字
proxy:、Connection refused、Timeout、No route to host、Connection reset - 典型报错示例：
[proxy:error] AH00957: http: failed to make connection to backend → 后端不可达
[proxy:error] AH00898: Error reading from remote server → 后端提前关闭连接
调整代理超时与连接参数
默认超时（如 30 秒）可能不足以应对慢后端或网络延迟：
- 在
ProxyPass行后添加参数，例如：ProxyPass / http://127.0.0.1:8080/ timeout=60 retry=0 keepalive=On -
timeout：Apache 等待后端响应的最大秒数 -
retry=0：禁用故障主机缓存，便于快速重试（调试阶段建议设为 0） -
keepalive=On：复用 TCP 连接，减少握手开销，对 HTTP/1.1 后端较有用
不复杂但容易忽略。重点是先看日志、再直连后端、最后调参数。多数 502 都卡在后端没起来、端口不通、或防火墙/SELinux 拦截了 Apache 到后端的出站连接。
