如何修復常見的 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 之前運行此命令是一個很好的做法，以避免語法錯誤引起的任何問題。