萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 伺服器教學

Nginx 自訂 404 錯誤頁面:正確回傳 404 狀態碼的關鍵細節

常見陷阱:錯誤頁面回傳 200 OK

許多開發者在 nginx.conf 設定自訂錯誤頁面時,習慣寫成:

error_page 404 = /404.php;

這會導致 Nginx 將 404 狀態碼「覆寫」為 200,搜尋引擎爬蟲會誤判頁面正常,嚴重影響 SEO。

正確寫法:移除等號

server {
    ...
    error_page 404 /404.php;  # 無等號,保持原始 404 狀態碼
    ...
}

進階配置範例

1. 啟用 FastCGI 錯誤攔截

http {
    fastcgi_intercept_errors on;  # 讓 Nginx 接管後端錯誤回應
    ...
}

2. 特定路徑專屬 404 頁面

location /my_blog {
    error_page 404 /article_not_found.html;
}

3. 多狀態碼共用錯誤頁面

location /my_blog {
    error_page 500 502 503 504 /server_error.html;
}

4. 錯誤轉發至備援上游伺服器

upstream server2 {
    server 10.0.0.1:80;
}

server {
    location /my_blog {
        error_page 404 = @try_server2;  # 此處需用 = 配合 named location
    }

    location @try_server2 {
        proxy_pass https://server2;
    }
}

適用於 Nginx 前端 + Apache 後端架構,主站掛掉時自動切換備援。

驗證與重載

  1. 測試配置語法:/usr/local/nginx/sbin/nginx -t
  2. 無錯誤後平滑重載:/etc/init.d/nginx reload 或 nginx -s reload
  3. 實測:curl -I https://your-domain/nonexistent 確認回傳 HTTP/1.1 404 Not Found

狀態碼對照表

狀態碼含義典型場景
404Not Found資源不存在
500Internal Server Error應用程式例外
502Bad Gateway上游伺服器回應無效
503Service Unavailable服務暫時不可用(維護/過載)
504Gateway Timeout上游伺服器逾時

最佳實踐:自訂錯誤頁面應包含友善提示、站內搜尋、網站地圖連結,並確保頁面大小 < 1KB 以利快速傳輸。記得在 404.php 中手動送出 header:header("HTTP/1.1 404 Not Found");(PHP 範例)。

copyright © 萬盛學電腦網 all rights reserved