Nginx 自訂 404 錯誤頁面正確配置：避免返回 200 狀態碼的關鍵細節

配置 Nginx 自訂錯誤頁面時，常見錯誤是在 error_page 指令後加上 = 號，導致 Nginx 回傳 **200 OK** 而非 **404 Not Found**，影響 SEO 與監控告警。本文說明正確寫法、多狀態碼共用頁面、反向代理備援、測試驗證全流程。

核心錯誤與正確寫法

# ❌ 錯誤：加上 = 號會將回應碼改為 200
error_page 404 = /404.php;

# ✅ 正確：不加 = 號，保持原狀態碼 404
error_page 404 /404.php;

= 代表「將指定錯誤碼重寫為新狀態碼」，error_page 404 =200 /404.php 才是合法語法。單純 error_page 404 = /404.php 會被解析為「將 404 改為 200 並顯示 /404.php」。

進階用法

1. 多狀態碼共用同一錯誤頁面

# 5xx 伺服器錯誤共用頁面
error_page 500 502 503 504 /server_error.html;

2. 特定 Location 區塊獨立錯誤頁面

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

3. 反向代理架構：上游失效切換備援伺服器

upstream backend2 {
    server 10.0.0.1:80;
}

server {
    location /my_blog {
        error_page 404 = @try_backend2;   # 這裡用 = 觸發 named location
    }

    location @try_backend2 {
        proxy_pass https://backend2;
    }
}

此模式常用於 **Nginx 前端 + Apache 後端** 架構：Nginx 處理靜態/快取，動態請求代理至 Apache；若 Apache 回 404 再嘗試備援節點。

4. 攔截 FastCGI/PHP 回傳的錯誤碼

fastcgi_intercept_errors on;   # 啟用後 Nginx 會處理上游回傳的 4xx/5xx
error_page 404 /404.php;

預設 Nginx 直接透傳上游回應；開啟後可統一錯誤頁面風格。

完整配置範例

server {
    listen 80;
    server_name example.com;
    root /var/www/example.com;

    # 全站 404 頁面
    error_page 404 /404.html;

    # 5xx 頁面
    error_page 500 502 503 504 /50x.html;

    # 靜態資源快取
    location ~* \.(jpg|jpeg|png|gif|ico|css|js|woff2?)$ {
        expires 30d;
        access_log off;
    }

    # PHP 處理
    location ~ \.php$ {
        fastcgi_pass unix:/run/php/php8.2-fpm.sock;
        fastcgi_index index.php;
        include fastcgi_params;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        fastcgi_intercept_errors on;
    }
}

測試驗證步驟

1. 語法檢查：nginx -t 或 /usr/local/nginx/sbin/nginx -t
2. 重載配置：nginx -s reload 或 systemctl reload nginx
3. 驗證狀態碼：

   curl -I https://example.com/nonexistent-page
   # 預期輸出
   HTTP/1.1 404 Not Found
   Content-Type: text/html
   ...

4. 驗證頁面內容**：curl https://example.com/nonexistent-page | grep -c "自訂錯誤頁關鍵字"

常見坑點總結

記住：**不加等號保持原狀態碼，加等號必須指定新狀態碼**。正確配置自訂錯誤頁面，既能提升用戶體驗，又能維持正確的 HTTP 語義，利於 SEO 與監控系統準確判斷服務健康度。