error_page的概念

error_page是nginx一個重要的指令，作用是定制化服務器錯誤頁面。當nginx發(fā)生內(nèi)部錯誤時，比如說404、403、500等錯誤，默認會跳轉(zhuǎn)到nginx自帶的錯誤頁面。但是使用error_page指令可以修改默認錯誤頁面，并且可以指定跳轉(zhuǎn)的url或者文件路徑。

語法：

error_page code [ code... ] [ = | =answer-code ] uri | @named_location 

默認值：

no 

 使用字段：http, server, location, location 中的if字段 

使用舉例

跳轉(zhuǎn)到指定頁面

其原理是響應到錯誤代碼后，導向指定的路由，然后再由指定的路由處理，如下當錯誤代碼是404時，相當于訪問http://localhost:80/50x.html，正好被內(nèi)部傳送給 location = /50x.html讓其來進行處理（需要注意必須有50x.html這個頁面）

        error_page 404 403 500 /50x.html;
        location = /50x.html {
                root /usr/share/nginx/html;
        }

跳轉(zhuǎn)到指定網(wǎng)址

其原理是響應到錯誤代碼后，302（臨時重定向到目標網(wǎng)址），如下當錯誤代碼為404時，導向https://www.csdn.net

error_page 404 403 500 https://www.csdn.net;

使用location的@符合完成錯誤信息展示

server{
	error_page 404 @jump_to_error;
	location @jump_to_error {
		default_type text/plain;
		return 404 'Not Found Page...';
	}
}

?更改反饋狀態(tài)碼  

本來遇到404找不到文件的錯誤，但是nginx可以把它狀態(tài)碼改為200返回給用戶（例子如下） ? 

        error_page 404 =200 /50x.html;#注意這里的縮進不是隨便的
        location = /50x.html {
                root /usr/share/nginx/html;
        }

error_page配置小提示

注意 error_page 配置時加 = 和不加 = 的區(qū)別，加了 = 表示響應為指定的 http status code ，默認為 200，不加 = 為原錯誤的狀態(tài)碼~

# 這樣可以訪問錯誤頁面時 http status 為 404 ，并且頁面內(nèi)容是 404.html 的內(nèi)容
error_page 404 /404.html
error_page 404 500 /404.html;
# 這樣配置訪問錯誤頁面時 http status 為 200 ，但頁面內(nèi)容是 404.html 的內(nèi)容
error_page 404 500 = /404.html;
# 這樣配置訪問錯誤頁面時 http status 為 404 ，但頁面內(nèi)容是 404.html 的內(nèi)容
error_page 404 500 =404 /404.html;
# 也可以把404請求直接301到某個域上
error_page 404 =301 https://xuexb.com/404;

這樣就可以根據(jù)自己需求配置錯誤頁為指定的狀態(tài)碼，因為非 200 的狀態(tài)碼可能會被瀏覽器攔截。

• error_page 404 /404.html        可顯示自定義404頁面內(nèi)容，正常返回404狀態(tài)碼。
• error_page 404 = /404.html    可顯示自定義404頁面內(nèi)容，但返回默認200狀態(tài)碼。
• error_page 404 /404.php        如果是動態(tài)404錯誤頁面，包含 header 代碼（例如301跳轉(zhuǎn)），將無法正常執(zhí)行。正常返回404代碼。
• error_page 404 = /404.php     如果是動態(tài)404錯誤頁面，包含 header 代碼（例如301跳轉(zhuǎn)），加等號配置可以正常執(zhí)行，返回php中定義的狀態(tài)碼。但如果php中定義返回404狀態(tài)碼，404狀態(tài)碼可以正常返回，但無法顯示自定義頁面內(nèi)容（出現(xiàn)系統(tǒng)默認404頁面），這種情況可以考慮用410代碼替代（ header("HTTP/1.1 410 Gone"); 正常返回410狀態(tài)碼，且可正常顯示自定義內(nèi)容）。

實戰(zhàn)應用解讀

限流應用

由于在nginx配置中，設置了limit_req的流量限制，導致許多請求返回503錯誤代碼，在限流的條件下，為提高用戶體驗，希望返回正常Code 200，且返回操作頻繁的信息：

location  /test {
  ... 
  limit_req zone=zone_ip_rm burst=1 nodelay; 
  error_page 503 =200 /dealwith_503?callback=$arg_callback;
}
location /dealwith_503{ 
  set $ret_body '{"code": "V00006","msg": "操作太頻繁了，請坐下來喝杯茶。"}';
   if ( $arg_callback != "" ) 
   { 
       return 200 'try{$arg_callback($ret_body)}catch(e){}'; 
   } 
   return 200 $ret_body; 
}

尋找錯誤碼對應的文件

error_page后面跟的/error/404.html就相當于其訪http://localhost:80/error/404.html其被location /error捕獲

        error_page 404 /error/404.html;
        error_page 403 /error/403.html;
        location /error {
                alias /var/www/html;
        }

到此這篇關于深入理解Nginx之error_page模塊的使用的文章就介紹到這了,更多相關Nginx error_page內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章希望大家以后多多支持腳本之家！ 

最新評論