解决 nginx proxy_pass 返回 502 bad gateway 错误,核心在于确保后端服务正在运行且监听在正确的端口和地址上。通常做法是检查后端进程状态、确认 nginx 配置中的 upstream 或 server 指令指向无误,并验证防火墙是否放行相关端口。若后端服务正常但依然报错,需排查 nginx 与后端之间的网络连通性及超时设置。

Nginx 配置中 proxy_pass 的常见错误写法有哪些
常见的配置错误包括 URL 路径拼接问题、协议头不匹配以及上游服务器定义缺失。例如,在 location 块中使用 proxy_pass 时,若末尾斜杠处理不当,会导致请求路径被意外修改。此外,若 upstream 块中未正确指定后端 IP 和端口,Nginx 将无法建立连接。

server {
listen 80;
server_name example.com;
location /api/ {
proxy_pass http://127.0.0.1:8080/;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
}
上述配置将 /api/ 开头的请求转发至后端的根路径。若去掉末尾斜杠,请求 /api/test 将被转发为 /api/test 而非 /test,这可能导致后端路由无法匹配。确保 proxy_pass 的目标地址包含正确的协议(如 http://)和端口号是关键。
如何排查后端服务不可达导致的 502 错误
当后端服务崩溃或未启动时,Nginx 会直接返回 502 错误。排查步骤包括使用 curl 命令测试后端本地接口,检查系统日志确认服务状态,以及验证网络连接。若后端服务监听的是 Unix Socket 而非 TCP 端口,需相应调整 proxy_pass 的配置格式。
Gate DEX 交易执行技能。用于修改区块链状态的链上代币兑换交易:兑换(swap)、买入(buy)、卖出(sell)、代币交换(exchange)、代币转换(convert tokens)、跨链(cross-chain)……

# 测试后端服务是否响应 curl -v http://127.0.0.1:8080/api/test # 检查 Nginx 错误日志 tail -f /var/log/nginx/error.log
通过 curl 访问后端,若返回连接拒绝(Connection refused),则说明后端服务未运行或端口错误。查看 Nginx 错误日志,若出现 connect() failed (111: Connection refused),则进一步证实后端不可达。此时应重启后端服务或修正其监听配置。
proxy_pass 配置中 upstream 模块的作用是什么
upstream 模块用于定义一组后端服务器,实现负载均衡和高可用。它允许 Nginx 将请求分发到多个后端实例,避免单点故障。在 proxy_pass 中引用 upstream 名称,而非直接写 IP 地址,可以简化配置并提高灵活性。
upstream backend_servers {
server 192.168.1.10:8080;
server 192.168.1.11:8080;
}
server {
location / {
proxy_pass http://backend_servers;
}
}
该配置将请求分发到两个后端服务器。若其中一个宕机,Nginx 会自动将流量转向另一个健康节点。这种机制有效提升了服务的稳定性,是解决 502 错误的重要架构手段。

















