如何修复 502 Bad Gateway NGINX 错误？ （7 种方法）

是什么导致 502 Bad Gateway Nginx 错误？

Nginx 中出现 502 Bad Gateway 错误的原因可能有多种，但下面列出了一些最常见的原因：

服务器过载

当后端服务器收到太多请求时，它可能会超载并且无法在超时期限内响应。 这会导致 502 错误，因为上游服务器无法满足客户端的请求。 适当的服务器规模调整、资源分配、负载平衡和扩展策略可以防止服务器过载。

连接问题

• 当反向代理服务器和后端服务器之间的网络连接出现问题时，连接问题会导致 Nginx 出现 502 Bad Gateway 错误。
• 这可能是由于网络拥塞、网络设置配置错误或硬件故障造成的。
• 当反向代理服务器尝试向后端服务器转发请求但无法建立连接时，它会向客户端返回 502 错误。
• 出现该错误是因为反向代理服务器充当客户端和后端服务器之间的中介，无法连接到后端服务器来完成客户端的请求。
• 排除网络设置故障、检查防火墙规则和监控网络流量有助于解决问题。

DNS 问题

• 当后端服务器的 DNS 解析失败时，DNS 问题会导致 Nginx 出现 502 Bad Gateway 错误。
• 发生这种情况的原因可能是 DNS 配置不正确、DNS 服务器故障或 DNS 缓存问题。
• 当客户端向反向代理服务器发送请求时，反向代理服务器需要将后端服务器的域名解析为IP地址。
• 如果DNS解析失败，反向代理服务器无法将请求转发给后端服务器，导致返回给客户端502错误。

阅读：什么是 DNS？

防火墙限制

• 当防火墙阻止反向代理服务器和后端服务器之间的连接时，防火墙限制会导致 Nginx 出现 502 Bad Gateway 错误。
• 当防火墙配置为限制进出特定 IP 地址或端口的流量时，可能会发生这种情况。
• 当反向代理服务器尝试连接到后端服务器，但防火墙阻止连接时，它会向客户端返回 502 错误。
• 出现这种情况是因为反向代理服务器充当了客户端和后端服务器之间的中介，无法与后端服务器建立连接来完成客户端的请求。
• 要修复导致 502 错误的防火墙相关问题，您可能需要调整防火墙规则以允许流量在反向代理和后端服务器之间流动。

软件错误

• 由于反向代理服务器或后端服务器中的软件错误或配置错误，可能会出现 502 Bad Gateway 错误。
• 由于服务器模块或应用程序的编码错误或配置错误，可能会发生此错误。
• 如果任一服务器的软件或配置存在错误，则可能无法在超时时间内处理请求或响应，从而导致向客户端返回 502 错误。
• 要修复导致 502 错误的软件相关问题，您可能需要检查反向代理和后端服务器的日志以识别任何错误或警告消息。

PHP-FMP 响应时间太长

• PHP-FPM（FastCGI Process Manager）在超时时间内未能响应或遇到严重错误时，会导致 Nginx 出现 502 Bad Gateway 错误。
• 由于资源不足、配置错误或 PHP 代码中的错误，可能会发生此错误。
• PHP-FPM 是在 Nginx 中运行 PHP 应用程序的一种流行方式，其中 Nginx 将请求发送到 PHP-FPM，它处理 PHP 代码并将结果返回给 Nginx，然后 Nginx 将响应发送回客户端。
• 要修复与 PHP-FPM 相关的问题，您可能需要调整 PHP-FPM 配置以增加进程或线程的数量或调整超时设置。
• 您可能还需要检查 PHP 代码以识别和修复任何错误或性能问题。
• 此外，监视服务器日志和系统资源可以帮助识别任何可能表明 PHP-FPM 存在更大问题的模式或趋势。

阅读：如何修复 HTTP 504 网关超时错误？

检查 Nginx 的状态

您需要做的第一件事是检查 Nginx 是否正在运行并响应请求。 为此，请运行下面给出的以下命令：

如果 Nginx 正在运行，您将收到类似这样的输出消息，

nginx.service - The nginx HTTP Server
Loaded: loaded (/lib/systemd/system/nginx.service; enabled; vendor preset: enabled)
Active: active (running) since Wed 2022-10-11 10:25:41 UTC; 1 days ago
Docs: https://httpd.nginx.org/docs/2.4/

如果 Nginx 没有运行，你会得到类似这样的输出消息，

nginx.service - The nginx HTTP Server
Loaded: loaded (/lib/systemd/system/nginx.service; enabled; vendor preset: enabled)
Active: inactive (dead) since Fri 2022-10-11 10:25:41 UTC; 25s ago
Docs: https://httpd.nginx.org/docs/2.4/

现在，如果 Nginx 没有运行，您必须使用以下命令重新启动它，

systemctl start nginx

检查后端服务器状态

• 登录到托管 Nginx 的反向代理服务器。
• 打开终端窗口并运行以下命令：

curl -I http://backend-server-ip-address/

• 将“backend-server-ip-address”替换为您的后端服务器的IP 地址。

• 检查命令输出中的HTTP 状态代码。 如果后端服务器运行正常，您应该会看到状态代码 200 OK。

• 如果您收到的状态代码不是200，则表示后端服务器可能有问题。 您可以通过检查后端服务器的日志以识别任何错误或警告消息来进一步调查问题。

检查 DNS 配置

如果DNS解析失败，则反向代理服务器无法将请求转发给后端服务器，从而导致向客户端返回502 Bad Gateway错误。 因此，验证后端服务器的 DNS 配置是否正确非常重要。

要检查 DNS 配置，您可以执行以下步骤：

• 登录到托管 Nginx 的反向代理服务器。
• 打开终端窗口并运行以下命令：

nslookup backend-server-domain-name

将“backend-server-domain-name”替换为您的后端服务器的域名。

• 检查命令的输出以验证是否为后端服务器返回了正确的IP 地址。

• 如果命令的输出显示DNS解析失败，则可能是DNS配置有问题。 您可以通过检查后端服务器域名的 DNS 设置或联系您的 DNS 提供商寻求帮助来进一步调查问题。

检查防火墙配置

建议检查防火墙日志是否有异常块。 有时防火墙还会阻止或阻止站点。 要解决此问题，您需要暂时禁用防火墙并检查问题是否仍然存在或已解决。

增加缓冲区大小

增加缓冲区大小允许 Nginx 存储更多来自服务器响应的数据，确保响应完整且无错误。 要增加缓冲区大小，您需要编辑 Nginx 配置文件并添加以下指令。

• proxy_buffer_size ：设置每个缓冲区的大小。 默认值通常为 4K。 您可以根据服务器的要求将其增加到更高的值。 例如，要将缓冲区大小设置为 16K，请将以下行添加到您的配置文件中：

proxy_buffer_size 16k;

• proxy_buffers ：设置要分配的缓冲区数。 默认值通常为 8。您可以根据服务器的要求将其增加到更高的值。 例如，要将缓冲区数设置为 32，将缓冲区大小设置为 16K，请将以下行添加到您的配置文件中：

proxy_buffers 32 16k;

注意：请务必注意，增加缓冲区大小和缓冲区数量会增加服务器上的内存使用量。 因此，您应该尝试不同的缓冲区大小和缓冲区数量，以找到适合您的服务器和应用程序的最佳设置。

• 对 Nginx 配置文件进行更改后，保存文件并重新启动 Nginx 以使更改生效。 您可以通过运行以下命令来执行此操作：

sudo service nginx restart

重启 Nginx 服务器

在某些情况下，只需重新启动 Nginx 服务器即可解决 502 bad gateway Nginx 错误。 去做这个，

您需要在终端或 shell 中运行命令。 确切的命令取决于您使用的操作系统和发行版，但这里有几个示例：

• Ubuntu 和 Debian：

sudo service nginx restart

• CentOS、Fedora 和 RHEL：

sudo systemctl restart nginx

• 苹果电脑：

sudo nginx -s reload

这些命令将优雅地重启 Nginx 服务器，这意味着它将等待所有活动连接完成，然后再关闭并重新启动。

检查 PHP-FPM 状态

有时，502 Bad Gateway Nginx 错误也可能由未运行的 PHP-FPM 触发。 因此，需要检查PHP-FPM的状态，确保其正常运行。

要检查运行状态，可以使用以下命令，

sudo service php-fpm status

如果 PHP-FPM 正在运行，您应该会看到一条消息表明它处于活动状态。

但是，如果 PHP-FPM 没有运行，您可以尝试使用以下命令重新启动它：

sudo service php-fpm restart

此命令将重新启动 PHP-FPM 服务，这有助于解决可能触发 502 错误网关 Nginx 错误的任何问题。

概括

502 Bad Gateway Nginx 错误是 Nginx 用户可能遇到的常见错误。 它通常是由连接问题、服务器过载、DNS 问题、防火墙限制或软件错误引起的。

但是，按照本文概述的步骤，您可以排除故障并解决 502 bad gateway nginx 错误。

不幸的是，如果上述方法都不适合您，请考虑从 Nginx 论坛或经验丰富且合格的 Nginx 顾问寻求帮助。

如果您对这篇文章中我们可能遗漏的 502 Bad Gateway Nginx 错误有任何提示或建议，或者如果您想分享您的经验，请在下面的评论部分告诉我们。 我们欢迎您的意见。

阅读：如何修复 WordPress 中的 HTTP 500 内部服务器错误？

经常问的问题