如何修复常见的 Nginx 错误消息：分步指南

如何修复 NGINX 错误？

既然您已经了解了一些常见的 NGINX 错误，您可能会想到一个问题：“如何修复 NGINX 错误？”

好吧，答案并不像看起来那么难。 有多种故障排除方法可用于 NGINX 错误。 但是，需要注意的是，这些故障排除方法仅适用于初始阶段。 需要进一步调查以确定问题的确切原因。

基本上有三个命令可以帮助您开始 NGINX 错误的故障排除之旅。

• 使用此命令获取错误日志和问题的详细信息： sudo cat /var/log/nginx/error.log
• 用于检查 Nginx 活动状态： sudo systemctl status nginx
• 检查配置文件中的语法错误： sudo nginx -t

1.使用错误日志排查Nginx错误

当你遇到 NGINX 的问题时，这些 NGINX 错误大多是模糊的，要简单地找出实际问题并不容易。 该错误可能是由于更大的问题而触发的，也可能是完全不相关的。

这完全取决于您如何配置 NGINX 设置以及您面临的具体情况。

要更好地了解正在发生的 NGINX 错误，您可以运行命令来查看这些错误的列表。 这是命令：

sudo cat /var/log/nginx/error.log

要运行此命令，您需要成为特权用户。 建议使用 sudo 访问权限而不是使用 root 用户。

此命令允许您读取 /var/log/nginx/error.log 文件的全部内容，其中包含 NGINX 错误日志。 它将在您的终端窗口中显示这些日志。

通过运行此命令，您将能够看到已记录的 NGINX 错误列表。 如果日志中没有记录错误，请记住一件事，运行命令时您将看不到任何输出。

这是一个错误日志示例供您参考，

2023/05/31 10:15:23 [error] 1234#0: *1 open() "/var/www/html/missing-page.html"
failed (2: No such file or directory), client: 192.168.0.1, server: example.com,
request: "GET /nonexistent-page HTTP/1.1", host: "example.com"

2023/05/31 12:45:57 [error] 1234#0: *2 upstream timed out (110: Connection timed out)
while reading response header from upstream, client: 192.168.0.2, server:
example.com, request: "GET /api/data HTTP/1.1", upstream:
"http://127.0.0.1:8000/api/data", host: "example.com"

2023/05/31 15:22:10 [error] 1234#0: *3 rewrite or internal redirection cycle while internally redirecting to "/index.php", client: 192.168.0.3, server: example.com, request: "GET /category/products/ HTTP/1.1", host: "example.com"

在此示例中，每一行代表 NGINX 记录的一个单独错误。 让我们分解提供的信息：

• 时间戳：每行的第一部分显示错误发生的日期和时间，格式为YYYY/MM/DD HH:MM:SS 。
• 错误级别： [error]标记表示此行表示错误。
• 进程 ID： #符号后的数字（例如1234#0 ）表示处理请求的 NGINX 进程 ID。
• 错误消息：错误消息提供有关特定错误的详细信息。 它包括文件或资源访问失败、上游连接超时或内部重定向问题等信息。
• 客户端 IP： client端字段显示向服务器发出请求的客户端的 IP 地址。
• 服务器名称： server字段表示发生错误的服务器名称或虚拟主机。
• Request Details： request字段显示客户端使用的 HTTP 方法、请求的 URL 和协议版本。
• 主机： host字段指定请求中使用的主机名或 IP 地址。

每个错误日志条目通过提供有关错误类型、受影响的资源、客户端 IP 和其他相关详细信息的信息来帮助诊断和解决问题。

2. 通过检查其状态排除 NGINX 故障

您可以尝试排除 NGINX 故障的另一种方法是检查其状态，即它是否处于活动状态。 由于某些原因，安装过程可能无法完成或服务尚未激活。

要检查 NGINX 服务状态，请使用以下命令：

sudo systemctl status nginx

如果 NGINX 服务处于活动状态，输出将是；

nginx.service - The NGINX HTTP and reverse proxy server
Loaded: loaded (/lib/systemd/system/nginx.service; enabled; vendor preset:
enabled)
Active: active (running) since Mon 2023-05-31 14:30:00 UTC; 5min ago
Docs: http://nginx.org/en/docs/
Process: 1234 ExecStart=/usr/sbin/nginx -g daemon on;
master_process on;
(code=exited, status=0/SUCCESS)
Main PID: 1234 (nginx)
Tasks: 2 (limit: 2319)
Memory: 3.9M
CGroup: /system.slice/nginx.service
├─1234 nginx: master process /usr/sbin/nginx -g daemon on; master_process on;
└─5678 nginx: worker process

如果 NGINX 状态为非活动状态，则sudo systemctl status nginx命令的输出将指示该服务处于非活动状态或已停止，如下所示。

nginx.service - The NGINX HTTP and reverse proxy server
Loaded: loaded (/lib/systemd/system/nginx.service; enabled; vendor preset: enabled)
Active: inactive (dead)
Docs: http://nginx.org/en/docs/

如果是这样，您唯一需要做的就是使用以下命令重新启动 NGINX 服务：

sudo systemctl restart nginx

之后，您可以再次使用 status 命令来检查 NGINX 服务现在是否处于活动状态。

3. 通过检查语法错误排除 NGINX 问题

语法错误是编写脚本、代码或配置 Nginx 文件时可能出现的常见问题。

无论您使用了不正确的语法结构还是省略了某些字符，不正确的语法都会导致代码或配置无法正常运行。

对于 Nginx 配置文件，它们包含各种指令，每个指令都需要准确声明才能正常运行。 否则，它将无法按预期工作。

要检查 Nginx 配置文件中的任何语法错误，请使用以下命令。

sudo nginx -t

如果语法被证明是正确的，输出将是，

nginx: configuration file /etc/nginx/nginx.conf test is successful

但是，如果语法有问题，输出将显示为，

nginx: [emerg] unexpected end of file, expecting ";" or "}" in
/etc/nginx/nginx.conf:42
nginx: configuration file /etc/nginx/nginx.conf test failed

通过执行此检查，您可以识别并纠正任何语法错误，从而确保您的 Nginx 配置准确且完整。 每次更改配置文件或重新启动 Nginx 之前运行此命令是一个很好的做法，以避免语法错误引起的任何问题。