Nginx常見錯誤及處理方法
原文轉載:https://www.cnblogs.com/liyongsan/p/6795851.html
404 bad request
一般原因:請求的Header過大。 解決方法:配置nginx.conf相關設定
client_header_buffer_size 16k;
large_client_header_buffers 4 64k;
413 Request Entity Too Large
一般原因:一般出現在上傳檔案。 解決方法:配置nginx.conf相關設定,配置php.ini如下(必須和nginx.conf配置一致)
client_max_body_size 10m;
post_max_size=10M
upload_max_filesize=2M
499 Client Closed Request
一般原因:客戶端在為等到伺服器相應返回前就關閉了客戶端描述符。一般出現在客戶端設定超時後,主動關閉socket.
解決方法:根據實際Nginx後端伺服器的處理時間修改客戶端超時時間。
500 Internal Server Rrror
一般原因:指令碼錯誤,(php語法錯誤、lua語法錯誤)
訪問量過大,系統資源限制,不能開啟過多檔案
磁碟空間不足。(access log開啟可能導致磁碟滿溢 關閉)
解決方法:語法錯誤檢視nginx_err_log php_err_log。
檔案訪問量:
1. 修改nginx配置檔案
worker_rlimit_nofile 65535;
2.修改/etc/security/limits.conf
* soft nofile 65535
* hard nofile 65535
502 Bad Gateway、503 Serveice Unavailable
一般原因:後端服務無法處理,業務中斷。
解決方法:從後端日誌獲取錯誤原因,解決後端伺服器問題。
504 Gateway Timeout
一般原因:後端伺服器在超時時間內,未響應Nginx代理請求
解決方法:根據後端伺服器實際處理情況,調正後端請求超時時間。
proxy_read_timeout 90;
proxy_send_timeout 90;
一般原因:可能網站頁面快取大,而fastcgi預設程序響應快取區8k
解決方法:配置nginx.conf相關設定
fastcgi_buffers 8 128k
send_timeout 60;
1 ######Nginx配置檔案nginx.conf中文詳解#####
2
3 #定義Nginx執行的使用者和使用者組
4 user www www;
5
6 #nginx程序數,建議設定為等於CPU總核心數。
7 worker_processes 8;
8
9 #全域性錯誤日誌定義型別,[ debug | info | notice | warn | error | crit ]
10 error_log /usr/local/nginx/logs/error.log info;
11
12 #程序pid檔案
13 pid /usr/local/nginx/logs/nginx.pid;
14
15 #指定程序可以開啟的最大描述符:數目
16 #工作模式與連線數上限
17 #這個指令是指當一個nginx程序開啟的最多檔案描述符數目,理論值應該是最多開啟檔案數(ulimit -n)與nginx程序數相除,但是nginx分配請求並不是那麼均勻,所以最好與ulimit -n 的值保持一致。
18 #現在在linux 2.6核心下開啟檔案開啟數為65535,worker_rlimit_nofile就相應應該填寫65535。
19 #這是因為nginx排程時分配請求到程序並不是那麼的均衡,所以假如填寫10240,總併發量達到3-4萬時就有程序可能超過10240了,這時會返回502錯誤。
20 worker_rlimit_nofile 65535;
21
22
23 events
24 {
25 #參考事件模型,use [ kqueue | rtsig | epoll | /dev/poll | select | poll ]; epoll模型
26 #是Linux 2.6以上版本核心中的高效能網路I/O模型,linux建議epoll,如果跑在FreeBSD上面,就用kqueue模型。
27 #補充說明:
28 #與apache相類,nginx針對不同的作業系統,有不同的事件模型
29 #A)標準事件模型
30 #Select、poll屬於標準事件模型,如果當前系統不存在更有效的方法,nginx會選擇select或poll
31 #B)高效事件模型
32 #Kqueue:使用於FreeBSD 4.1+, OpenBSD 2.9+, NetBSD 2.0 和 MacOS X.使用雙處理器的MacOS X系統使用kqueue可能會造成核心崩潰。
33 #Epoll:使用於Linux核心2.6版本及以後的系統。
34 #/dev/poll:使用於Solaris 7 11/99+,HP/UX 11.22+ (eventport),IRIX 6.5.15+ 和 Tru64 UNIX 5.1A+。
35 #Eventport:使用於Solaris 10。 為了防止出現核心崩潰的問題, 有必要安裝安全補丁。
36 use epoll;
37
38 #單個程序最大連線數(最大連線數=連線數*程序數)
39 #根據硬體調整,和前面工作程序配合起來用,儘量大,但是別把cpu跑到100%就行。每個程序允許的最多連線數,理論上每臺nginx伺服器的最大連線數為。
40 worker_connections 65535;
41
42 #keepalive超時時間。
43 keepalive_timeout 60;
44
45 #客戶端請求頭部的緩衝區大小。這個可以根據你的系統分頁大小來設定,一般一個請求頭的大小不會超過1k,不過由於一般系統分頁都要大於1k,所以這裡設定為分頁大小。
46 #分頁大小可以用命令getconf PAGESIZE 取得。
47 #[[email protected] ~]# getconf PAGESIZE
48 #4096
49 #但也有client_header_buffer_size超過4k的情況,但是client_header_buffer_size該值必須設定為“系統分頁大小”的整倍數。
50 client_header_buffer_size 4k;
51
52 #這個將為開啟檔案指定快取,預設是沒有啟用的,max指定快取數量,建議和開啟檔案數一致,inactive是指經過多長時間檔案沒被請求後刪除快取。
53 open_file_cache max=65535 inactive=60s;
54
55 #這個是指多長時間檢查一次快取的有效資訊。
56 #語法:open_file_cache_valid time 預設值:open_file_cache_valid 60 使用欄位:http, server, location 這個指令指定了何時需要檢查open_file_cache中快取專案的有效資訊.
57 open_file_cache_valid 80s;
58
59 #open_file_cache指令中的inactive引數時間內檔案的最少使用次數,如果超過這個數字,檔案描述符一直是在快取中開啟的,如上例,如果有一個檔案在inactive時間內一次沒被使用,它將被移除。
60 #語法:open_file_cache_min_uses number 預設值:open_file_cache_min_uses 1 使用欄位:http, server, location 這個指令指定了在open_file_cache指令無效的引數中一定的時間範圍內可以使用的最小檔案數,如果使用更大的值,檔案描述符在cache中總是開啟狀態.
61 open_file_cache_min_uses 1;
62
63 #語法:open_file_cache_errors on | off 預設值:open_file_cache_errors off 使用欄位:http, server, location 這個指令指定是否在搜尋一個檔案是記錄cache錯誤.
64 open_file_cache_errors on;
65 }
66
67
68
69 #設定http伺服器,利用它的反向代理功能提供負載均衡支援
70 http
71 {
72 #副檔名與檔案型別對映表
73 include mime.types;
74
75 #預設檔案型別
76 default_type application/octet-stream;
77
78 #預設編碼
79 #charset utf-8;
80
81 #伺服器名字的hash表大小
82 #儲存伺服器名字的hash表是由指令server_names_hash_max_size 和server_names_hash_bucket_size所控制的。引數hash bucket size總是等於hash表的大小,並且是一路處理器快取大小的倍數。在減少了在記憶體中的存取次數後,使在處理器中加速查詢hash表鍵值成為可能。如果hash bucket size等於一路處理器快取的大小,那麼在查詢鍵的時候,最壞的情況下在記憶體中查詢的次數為2。第一次是確定儲存單元的地址,第二次是在儲存單元中查詢鍵 值。因此,如果Nginx給出需要增大hash max size 或 hash bucket size的提示,那麼首要的是增大前一個引數的大小.
83 server_names_hash_bucket_size 128;
84
85 #客戶端請求頭部的緩衝區大小。這個可以根據你的系統分頁大小來設定,一般一個請求的頭部大小不會超過1k,不過由於一般系統分頁都要大於1k,所以這裡設定為分頁大小。分頁大小可以用命令getconf PAGESIZE取得。
86 client_header_buffer_size 32k;
87
88 #客戶請求頭緩衝大小。nginx預設會用client_header_buffer_size這個buffer來讀取header值,如果header過大,它會使用large_client_header_buffers來讀取。
89 large_client_header_buffers 4 64k;
90
91 #設定通過nginx上傳檔案的大小
92 client_max_body_size 8m;
93
94 #開啟高效檔案傳輸模式,sendfile指令指定nginx是否呼叫sendfile函式來輸出檔案,對於普通應用設為 on,如果用來進行下載等應用磁碟IO重負載應用,可設定為off,以平衡磁碟與網路I/O處理速度,降低系統的負載。注意:如果圖片顯示不正常把這個改成off。
95 #sendfile指令指定 nginx 是否呼叫sendfile 函式(zero copy 方式)來輸出檔案,對於普通應用,必須設為on。如果用來進行下載等應用磁碟IO重負載應用,可設定為off,以平衡磁碟與網路IO處理速度,降低系統uptime。
96 sendfile on;
97
98 #開啟目錄列表訪問,合適下載伺服器,預設關閉。
99 autoindex on;
100
101 #此選項允許或禁止使用socke的TCP_CORK的選項,此選項僅在使用sendfile的時候使用
102 tcp_nopush on;
103
104 tcp_nodelay on;
105
106 #長連線超時時間,單位是秒
107 keepalive_timeout 120;
108
109 #FastCGI相關引數是為了改善網站的效能:減少資源佔用,提高訪問速度。下面引數看字面意思都能理解。
110 fastcgi_connect_timeout 300;
111 fastcgi_send_timeout 300;
112 fastcgi_read_timeout 300;
113 fastcgi_buffer_size 64k;
114 fastcgi_buffers 4 64k;
115 fastcgi_busy_buffers_size 128k;
116 fastcgi_temp_file_write_size 128k;
117
118 #gzip模組設定
119 gzip on; #開啟gzip壓縮輸出
120 gzip_min_length 1k; #最小壓縮檔案大小
121 gzip_buffers 4 16k; #壓縮緩衝區
122 gzip_http_version 1.0; #壓縮版本(預設1.1,前端如果是squid2.5請使用1.0)
123 gzip_comp_level 2; #壓縮等級
124 gzip_types text/plain application/x-javascript text/css application/xml; #壓縮型別,預設就已經包含textml,所以下面就不用再寫了,寫上去也不會有問題,但是會有一個warn。
125 gzip_vary on;
126
127 #開啟限制IP連線數的時候需要使用
128 #limit_zone crawler $binary_remote_addr 10m;
129
130
131
132 #負載均衡配置
133 upstream piao.jd.com {
134
135 #upstream的負載均衡,weight是權重,可以根據機器配置定義權重。weigth引數表示權值,權值越高被分配到的機率越大。
136 server 192.168.80.121:80 weight=3;
137 server 192.168.80.122:80 weight=2;
138 server 192.168.80.123:80 weight=3;
139
140 #nginx的upstream目前支援4種方式的分配
141 #1、輪詢(預設)
142 #每個請求按時間順序逐一分配到不同的後端伺服器,如果後端伺服器down掉,能自動剔除。
143 #2、weight
144 #指定輪詢機率,weight和訪問比率成正比,用於後端伺服器效能不均的情況。
145 #例如:
146 #upstream bakend {
147 # server 192.168.0.14 weight=10;
148 # server 192.168.0.15 weight=10;
149 #}
150 #2、ip_hash
151 #每個請求按訪問ip的hash結果分配,這樣每個訪客固定訪問一個後端伺服器,可以解決session的問題。
152 #例如:
153 #upstream bakend {
154 # ip_hash;
155 # server 192.168.0.14:88;
156 # server 192.168.0.15:80;
157 #}
158 #3、fair(第三方)
159 #按後端伺服器的響應時間來分配請求,響應時間短的優先分配。
160 #upstream backend {
161 # server server1;
162 # server server2;
163 # fair;
164 #}
165 #4、url_hash(第三方)
166 #按訪問url的hash結果來分配請求,使每個url定向到同一個後端伺服器,後端伺服器為快取時比較有效。
167 #例:在upstream中加入hash語句,server語句中不能寫入weight等其他的引數,hash_method是使用的hash演算法
168 #upstream backend {
169 # server squid1:3128;
170 # server squid2:3128;
171 # hash $request_uri;
172 # hash_method crc32;
173 #}
174
175 #tips:
176 #upstream bakend{#定義負載均衡裝置的Ip及裝置狀態}{
177 # ip_hash;
178 # server 127.0.0.1:9090 down;
179 # server 127.0.0.1:8080 weight=2;
180 # server 127.0.0.1:6060;
181 # server 127.0.0.1:7070 backup;
182 #}
183 #在需要使用負載均衡的server中增加 proxy_pass http://bakend/;
184
185 #每個裝置的狀態設定為:
186 #1.down表示單前的server暫時不參與負載
187 #2.weight為weight越大,負載的權重就越大。
188 #3.max_fails:允許請求失敗的次數預設為1.當超過最大次數時,返回proxy_next_upstream模組定義的錯誤
189 #4.fail_timeout:max_fails次失敗後,暫停的時間。
190 #5.backup: 其它所有的非backup機器down或者忙的時候,請求backup機器。所以這臺機器壓力會最輕。
191
192 #nginx支援同時設定多組的負載均衡,用來給不用的server來使用。
193 #client_body_in_file_only設定為On 可以講client post過來的資料記錄到檔案中用來做debug
194 #client_body_temp_path設定記錄檔案的目錄 可以設定最多3層目錄
195 #location對URL進行匹配.可以進行重定向或者進行新的代理 負載均衡
196 }
197
198
199
200 #虛擬主機的配置
201 server
202 {
203 #監聽埠
204 listen 80;
205
206 #域名可以有多個,用空格隔開
207 server_name www.jd.com jd.com;
208 index index.html index.htm index.php;
209 root /data/www/jd;
210
211 #對******進行負載均衡
212 location ~ .*.(php|php5)?$
213 {
214 fastcgi_pass 127.0.0.1:9000;
215 fastcgi_index index.php;
216 include fastcgi.conf;
217 }
218
219 #圖片快取時間設定
220 location ~ .*.(gif|jpg|jpeg|png|bmp|swf)$
221 {
222 expires 10d;
223 }
224
225 #JS和CSS快取時間設定
226 location ~ .*.(js|css)?$
227 {
228 expires 1h;
229 }
230
231 #日誌格式設定
232 #$remote_addr與$http_x_forwarded_for用以記錄客戶端的ip地址;
233 #$remote_user:用來記錄客戶端使用者名稱稱;
234 #$time_local: 用來記錄訪問時間與時區;
235 #$request: 用來記錄請求的url與http協議;
236 #$status: 用來記錄請求狀態;成功是200,
237 #$body_bytes_sent :記錄傳送給客戶端檔案主體內容大小;
238 #$http_referer:用來記錄從那個頁面連結訪問過來的;
239 #$http_user_agent:記錄客戶瀏覽器的相關資訊;
240 #通常web伺服器放在反向代理的後面,這樣就不能獲取到客戶的IP地址了,通過$remote_add拿到的IP地址是反向代理伺服器的iP地址。反向代理伺服器在轉發請求的http頭資訊中,可以增加x_forwarded_for資訊,用以記錄原有客戶端的IP地址和原來客戶端的請求的伺服器地址。
241 log_format access '$remote_addr - $remote_user [$time_local] "$request" '
242 '$status $body_bytes_sent "$http_referer" '
243 '"$http_user_agent" $http_x_forwarded_for';
244
245 #定義本虛擬主機的訪問日誌
246 access_log /usr/local/nginx/logs/host.access.log main;
247 access_log /usr/local/nginx/logs/host.access.404.log log404;
248
249 #對 "/" 啟用反向代理
250 location / {
251 proxy_pass http://127.0.0.1:88;
252 proxy_redirect off;
253 proxy_set_header X-Real-IP $remote_addr;
254
255 #後端的Web伺服器可以通過X-Forwarded-For獲取使用者真實IP
256 proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
257
258 #以下是一些反向代理的配置,可選。
259 proxy_set_header Host $host;
260
261 #允許客戶端請求的最大單檔案位元組數
262 client_max_body_size 10m;
263
264 #緩衝區代理緩衝使用者端請求的最大位元組數,
265 #如果把它設定為比較大的數值,例如256k,那麼,無論使用firefox還是IE瀏覽器,來提交任意小於256k的圖片,都很正常。如果註釋該指令,使用預設的client_body_buffer_size設定,也就是作業系統頁面大小的兩倍,8k或者16k,問題就出現了。
266 #無論使用firefox4.0還是IE8.0,提交一個比較大,200k左右的圖片,都返回500 Internal Server Error錯誤
267 client_body_buffer_size 128k;
268
269 #表示使nginx阻止HTTP應答程式碼為400或者更高的應答。
270 proxy_intercept_errors on;
271
272 #後端伺服器連線的超時時間_發起握手等候響應超時時間
273 #nginx跟後端伺服器連線超時時間(代理連線超時)
274 proxy_connect_timeout 90;
275
276 #後端伺服器資料回傳時間(代理髮送超時)
277 #後端伺服器資料回傳時間_就是在規定時間之內後端伺服器必須傳完所有的資料
278 proxy_send_timeout 90;
279
280 #連線成功後,後端伺服器響應時間(代理接收超時)
281 #連線成功後_等候後端伺服器響應時間_其實已經進入後端的排隊之中等候處理(也可以說是後端伺服器處理請求的時間)
282 proxy_read_timeout 90;
283
284 #設定代理伺服器(nginx)儲存使用者頭資訊的緩衝區大小
285 #設定從被代理伺服器讀取的第一部分應答的緩衝區大小,通常情況下這部分應答中包含一個小的應答頭,預設情況下這個值的大小為指令proxy_buffers中指定的一個緩衝區的大小,不過可以將其設定為更小
286 proxy_buffer_size 4k;
287
288 #proxy_buffers緩衝區,網頁平均在32k以下的設定
289 #設定用於讀取應答(來自被代理伺服器)的緩衝區數目和大小,預設情況也為分頁大小,根據作業系統的不同可能是4k或者8k
290 proxy_buffers 4 32k;
291
292 #高負荷下緩衝大小(proxy_buffers*2)
293 proxy_busy_buffers_size 64k;
294
295 #設定在寫入proxy_temp_path時資料的大小,預防一個工作程序在傳遞檔案時阻塞太長
296 #設定快取資料夾大小,大於這個值,將從upstream伺服器傳
297 proxy_temp_file_write_size 64k;
298 }
299
300
301 #設定檢視Nginx狀態的地址
302 location /NginxStatus {
303 stub_status on;
304 access_log on;
305 auth_basic "NginxStatus";
306 auth_basic_user_file confpasswd;
307 #htpasswd檔案的內容可以用apache提供的htpasswd工具來產生。
308 }
309
310 #本地動靜分離反向代理配置
311 #所有jsp的頁面均交由tomcat或resin處理
312 location ~ .(jsp|jspx|do)?$ {
313 proxy_set_header Host $host;
314 proxy_set_header X-Real-IP $remote_addr;
315 proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
316 proxy_pass http://127.0.0.1:8080;
317 }
318
319 #所有靜態檔案由nginx直接讀取不經過tomcat或resin
320 location ~ .*.(htm|html|gif|jpg|jpeg|png|bmp|swf|ioc|rar|zip|txt|flv|mid|doc|ppt|
321 pdf|xls|mp3|wma)$
322 {
323 expires 15d;
324 }
325
326 location ~ .*.(js|css)?$
327 {
328 expires 1h;
329 }
330 }
331 }
332 ######Nginx配置檔案nginx.conf中文詳解#####
中文配置詳解:
http://tool.oschina.net/apidocs/apidoc?api=nginx-zh
http://shouce.jb51.net/nginx/left.html
官方文件:
http://nginx.org/en/docs/http/ngx_http_core_module.html
附表:HTTP響應碼
1XX代表提示資訊,2XX代表成功資訊,3XX代表重定向資訊,4XX代表客戶端錯誤資訊,5XX代表伺服器錯誤資訊
狀態碼 含義
100 客戶端應當繼續傳送請求。這個臨時響應是用來通知客戶端它的部分請求已經被伺服器接收,且仍未被拒絕。客戶端應當繼續傳送請求的剩餘部分,或者如果請求已經完成,忽略這個響應。伺服器必須在請求完成後向客戶端傳送一個最終響應。
101 伺服器已經理解了客戶端的請求,並將通過Upgrade 訊息頭通知客戶端採用不同的協議來完成這個請求。在傳送完這個響應最後的空行後,伺服器將會切換到在Upgrade 訊息頭中定義的那些協議。 只有在切換新的協議更有好處的時候才應該採取類似措施。例如,切換到新的HTTP 版本比舊版本更有優勢,或者切換到一個實時且同步的協議以傳送利用此類特性的資源。
102 由WebDAV(RFC 2518)擴充套件的狀態碼,代表處理將被繼續執行。
200 請求已成功,請求所希望的響應頭或資料體將隨此響應返回。
201 請求已經被實現,而且有一個新的資源已經依據請求的需要而建立,且其 URI 已經隨Location 頭資訊返回。假如需要的資源無法及時建立的話,應當返回 '202 Accepted'。
202 伺服器已接受請求,但尚未處理。正如它可能被拒絕一樣,最終該請求可能會也可能不會被執行。在非同步操作的場合下,沒有比傳送這個狀態碼更方便的做法了。 返回202狀態碼的響應的目的是允許伺服器接受其他過程的請求(例如某個每天只執行一次的基於批處理的操作),而不必讓客戶端一直保持與伺服器的連線直到批處理操作全部完成。在接受請求處理並返回202狀態碼的響應應當在返回的實體中包含一些指示處理當前狀態的資訊,以及指向處理狀態監視器或狀態預測的指標,以便使用者能夠估計操作是否已經完成。
203 伺服器已成功處理了請求,但返回的實體頭部元資訊不是在原始伺服器上有效的確定集合,而是來自本地或者第三方的拷貝。當前的資訊可能是原始版本的子集或者超集。例如,包含資源的元資料可能導致原始伺服器知道元資訊的超級。使用此狀態碼不是必須的,而且只有在響應不使用此狀態碼便會返回200 OK的情況下才是合適的。
204 伺服器成功處理了請求,但不需要返回任何實體內容,並且希望返回更新了的元資訊。響應可能通過實體頭部的形式,返回新的或更新後的元資訊。如果存在這些頭部資訊,則應當與所請求的變數相呼應。 如果客戶端是瀏覽器的話,那麼使用者瀏覽器應保留髮送了該請求的頁面,而不產生任何文件檢視上的變化,即使按照規範新的或更新後的元資訊應當被應用到使用者瀏覽器活動檢視中的文件。 由於204響應被禁止包含任何訊息體,因此它始終以訊息頭後的第一個空行結尾。
205 伺服器成功處理了請求,且沒有返回任何內容。但是與204響應不同,返回此狀態碼的響應要求請求者重置文件檢視。該響應主要是被用於接受使用者輸入後,立即重置表單,以便使用者能夠輕鬆地開始另一次輸入。 與204響應一樣,該響應也被禁止包含任何訊息體,且以訊息頭後的第一個空行結束。
206 伺服器已經成功處理了部分 GET 請求。類似於 FlashGet 或者迅雷這類的 HTTP 下載工具都是使用此類響應實現斷點續傳或者將一個大文件分解為多個下載段同時下載。 該請求必須包含 Range 頭資訊來指示客戶端希望得到的內容範圍,並且可能包含 If-Range 來作為請求條件。 響應必須包含如下的頭部域: Content-Range 用以指示本次響應中返回的內容的範圍;如果是 Content-Type 為 multipart/byteranges 的多段下載,則每一 multipart 段中都應包含 Content-Range 域用以指示本段的內容範圍。假如響應中包含 Content-Length,那麼它的數值必須匹配它返回的內容範圍的真實位元組數。 Date ETag 和/或 Content-Location,假如同樣的請求本應該返回200響應。 Expires, Cache-Control,和/或 Vary,假如其值可能與之前相同變數的其他響應對應的值不同的話。 假如本響應請求使用了 If-Range 強快取驗證,那麼本次響應不應該包含其他實體頭;假如本響應的請求使用了 If-Range 弱快取驗證,那麼本次響應禁止包含其他實體頭;這避免了快取的實體內容和更新了的實體頭資訊之間的不一致。否則,本響應就應當包含所有本應該返回200響應中應當返回的所有實體頭部域。 假如 ETag 或 Last-Modified 頭部不能精確匹配的話,則客戶端快取應禁止將206響應返回的內容與之前任何快取過的內容組合在一起。 任何不支援 Range 以及 Content-Range 頭的快取都禁止快取206響應返回的內容。
207 由WebDAV(RFC 2518)擴充套件的狀態碼,代表之後的訊息體將是一個XML訊息,並且可能依照之前子請求數量的不同,包含一系列獨立的響應程式碼。
300 被請求的資源有一系列可供選擇的回饋資訊,每個都有自己特定的地址和瀏覽器驅動的商議資訊。使用者或瀏覽器能夠自行選擇一個首選的地址進行重定向。 除非這是一個 HEAD 請求,否則該響應應當包括一個資源特性及地址的列表的實體,以便使用者或瀏覽器從中選擇最合適的重定向地址。這個實體的格式由 Content-Type 定義的格式所決定。瀏覽器可能根據響應的格式以及瀏覽器自身能力,自動作出最合適的選擇。當然,RFC 2616規範並沒有規定這樣的自動選擇該如何進行。 如果伺服器本身已經有了首選的回饋選擇,那麼在 Location 中應當指明這個回饋的 URI;瀏覽器可能會將這個 Location 值作為自動重定向的地址。此外,除非額外指定,否則這個響應也是可快取的。
301 被請求的資源已永久移動到新位置,並且將來任何對此資源的引用都應該使用本響應返回的若干個 URI 之一。如果可能,擁有連結編輯功能的客戶端應當自動把請求的地址修改為從伺服器反饋回來的地址。除非額外指定,否則這個響應也是可快取的。 新的永久性的 URI 應當在響應的 Location 域中返回。除非這是一個 HEAD 請求,否則響應的實體中應當包含指向新的 URI 的超連結及簡短說明。 如果這不是一個 GET 或者 HEAD 請求,因此瀏覽器禁止自動進行重定向,除非得到使用者的確認,因為請求的條件可能因此發生變化。 注意:對於某些使用 HTTP/1.0 協議的瀏覽器,當它們傳送的 POST 請求得到了一個301響應的話,接下來的重定向請求將會變成 GET 方式。
302 請求的資源現在臨時從不同的 URI 響應請求。由於這樣的重定向是臨時的,客戶端應當繼續向原有地址傳送以後的請求。只有在Cache-Control或Expires中進行了指定的情況下,這個響應才是可快取的。 新的臨時性的 URI 應當在響應的 Location 域中返回。除非這是一個 HEAD 請求,否則響應的實體中應當包含指向新的 URI 的超連結及簡短說明。 如果這不是一個 GET 或者 HEAD 請求,那麼瀏覽器禁止自動進行重定向,除非得到使用者的確認,因為請求的條件可能因此發生變化。 注意:雖然RFC 1945和RFC 2068規範不允許客戶端在重定向時改變請求的方法,但是很多現存的瀏覽器將302響應視作為303響應,並且使用 GET 方式訪問在 Location 中規定的 URI,而無視原先請求的方法。狀態碼303和307被添加了進來,用以明確伺服器期待客戶端進行何種反應。
303 對應當前請求的響應可以在另一個 URI 上被找到,而且客戶端應當採用 GET 的方式訪問那個資源。這個方法的存在主要是為了允許由指令碼啟用的POST請求輸出重定向到一個新的資源。這個新的 URI 不是原始資源的替代引用。同時,303響應禁止被快取。當然,第二個請求(重定向)可能被快取。 新的 URI 應當在響應的 Location 域中返回。除非這是一個 HEAD 請求,否則響應的實體中應當包含指向新的 URI 的超連結及簡短說明。 注意:許多 HTTP/1.1 版以前的 瀏覽器不能正確理解303狀態。如果需要考慮與這些瀏覽器之間的互動,302狀態碼應該可以勝任,因為大多數的瀏覽器處理302響應時的方式恰恰就是上述規範要求客戶端處理303響應時應當做的。
304 如果客戶端傳送了一個帶條件的 GET 請求且該請求已被允許,而文件的內容(自上次訪問以來或者根據請求的條件)並沒有改變,則伺服器應當返回這個狀態碼。304響應禁止包含訊息體,因此始終以訊息頭後的第一個空行結尾。 該響應必須包含以下的頭資訊: Date,除非這個伺服器沒有時鐘。假如沒有時鐘的伺服器也遵守這些規則,那麼代理伺服器以及客戶端可以自行將 Date 欄位新增到接收到的響應頭中去(正如RFC 2068中規定的一樣),快取機制將會正常工作。 ETag 和/或 Content-Location,假如同樣的請求本應返回200響應。 Expires, Cache-Control,和/或Vary,假如其值可能與之前相同變數的其他響應對應的值不同的話。 假如本響應請求使用了強快取驗證,那麼本次響應不應該包含其他實體頭;否則(例如,某個帶條件的 GET 請求使用了弱快取驗證),本次響應禁止包含其他實體頭;這避免了快取了的實體內容和更新了的實體頭資訊之間的不一致。 假如某個304響應指明瞭當前某個實體沒有快取,那麼快取系統必須忽視這個響應,並且重複傳送不包含限制條件的請求。 假如接收到一個要求更新某個快取條目的304響應,那麼快取系統必須更新整個條目以反映所有在響應中被更新的欄位的值。
305 被請求的資源必須通過指定的代理才能被訪問。Location 域中將給出指定的代理所在的 URI 資訊,接收者需要重複傳送一個單獨的請求,通過這個代理才能訪問相應資源。只有原始伺服器才能建立305響應。 注意:RFC 2068中沒有明確305響應是為了重定向一個單獨的請求,而且只能被原始伺服器建立。忽視這些限制可能導致嚴重的安全後果。
306 在最新版的規範中,306狀態碼已經不再被使用。
307 請求的資源現在臨時從不同的URI 響應請求。由於這樣的重定向是臨時的,客戶端應當繼續向原有地址傳送以後的請求。只有在Cache-Control或Expires中進行了指定的情況下,這個響應才是可快取的。 新的臨時性的URI 應當在響應的 Location 域中返回。除非這是一個HEAD 請求,否則響應的實體中應當包含指向新的URI 的超連結及簡短說明。因為部分瀏覽器不能識別307響應,因此需要新增上述必要資訊以便使用者能夠理解並向新的 URI 發出訪問請求。 如果這不是一個GET 或者 HEAD 請求,那麼瀏覽器禁止自動進行重定向,除非得到使用者的確認,因為請求的條件可能因此發生變化。
400 1、語義有誤,當前請求無法被伺服器理解。除非進行修改,否則客戶端不應該重複提交這個請求。 2、請求引數有誤。
401 當前請求需要使用者驗證。該響應必須包含一個適用於被請求資源的 WWW-Authenticate 資訊頭用以詢問使用者資訊。客戶端可以重複提交一個包含恰當的 Authorization 頭資訊的請求。如果當前請求已經包含了 Authorization 證書,那麼401響應代表著伺服器驗證已經拒絕了那些證書。如果401響應包含了與前一個響應相同的身份驗證詢問,且瀏覽器已經至少嘗試了一次驗證,那麼瀏覽器應當向用戶展示響應中包含的實體資訊,因為這個實體資訊中可能包含了相關診斷資訊。參見RFC 2617。
402 該狀態碼是為了將來可能的需求而預留的。
403 伺服器已經理解請求,但是拒絕執行它。與401響應不同的是,身份驗證並不能提供任何幫助,而且這個請求也不應該被重複提交。如果這不是一個 HEAD 請求,而且伺服器希望能夠講清楚為何請求不能被執行,那麼就應該在實體內描述拒絕的原因。當然伺服器也可以返回一個404響應,假如它不希望讓客戶端獲得任何資訊。
404 請求失敗,請求所希望得到的資源未被在伺服器上發現。沒有資訊能夠告訴使用者這個狀況到底是暫時的還是永久的。假如伺服器知道情況的話,應當使用410狀態碼來告知舊資源因為某些內部的配置機制問題,已經永久的不可用,而且沒有任何可以跳轉的地址。404這個狀態碼被廣泛應用於當伺服器不想揭示到底為何請求被拒絕或者沒有其他適合的響應可用的情況下。
405 請求行中指定的請求方法不能被用於請求相應的資源。該響應必須返回一個Allow 頭資訊用以表示出當前資源能夠接受的請求方法的列表。 鑑於 PUT,DELETE 方法會對伺服器上的資源進行寫操作,因而絕大部分的網頁伺服器都不支援或者在預設配置下不允許上述請求方法,對於此類請求均會返回405錯誤。
406 請求的資源的內容特性無法滿足請求頭中的條件,因而無法生成響應實體。 除非這是一個 HEAD 請求,否則該響應就應當返回一個包含可以讓使用者或者瀏覽器從中選擇最合適的實體特性以及地址列表的實體。實體的格式由 Content-Type 頭中定義的媒體型別決定。瀏覽器可以根據格式及自身能力自行作出最佳選擇。但是,規範中並沒有定義任何作出此類自動選擇的標準。
407 與401響應類似,只不過客戶端必須在代理伺服器上進行身份驗證。代理伺服器必須返回一個 Proxy-Authenticate 用以進行身份詢問。客戶端可以返回一個 Proxy-Authorization 資訊頭用以驗證。參見RFC 2617。
408 請求超時。客戶端沒有在伺服器預備等待的時間內完成一個請求的傳送。客戶端可以隨時再次提交這一請求而無需進行任何更改。
409 由於和被請求的資源的當前狀態之間存在衝突,請求無法完成。這個程式碼只允許用在這樣的情況下才能被使用:使用者被認為能夠解決衝突,並且會重新提交新的請求。該響應應當包含足夠的資訊以便使用者發現衝突的源頭。 衝突通常發生於對 PUT 請求的處理中。例如,在採用版本檢查的環境下,某次 PUT 提交的對特定資源的修改請求所附帶的版本資訊與之前的某個(第三方)請求向衝突,那麼此時伺服器就應該返回一個409錯誤,告知使用者請求無法完成。此時,響應實體中很可能會包含兩個衝突版本之間的差異比較,以便使用者重新提交歸併以後的新版本。
410 被請求的資源在伺服器上已經不再可用,而且沒有任何已知的轉發地址。這樣的狀況應當被認為是永久性的。如果可能,擁有連結編輯功能的客戶端應當在獲得使用者許可後刪除所有指向這個地址的引用。如果伺服器不知道或者無法確定這個狀況是否是永久的,那麼就應該使用404狀態碼。除非額外說明,否則這個響應是可快取的。 410響應的目的主要是幫助網站管理員維護網站,通知使用者該資源已經不再可用,並且伺服器擁有者希望所有指向這個資源的遠端連線也被刪除。這類事件在限時、增值服務中很普遍。同樣,410響應也被用於通知客戶端在當前伺服器站點上,原本屬於某個個人的資源已經不再可用。當然,是否需要把所有永久不可用的資源標記為'410 Gone',以及是否需要保持此標記多長時間,完全取決於伺服器擁有者。
411 伺服器拒絕在沒有定義 Content-Length 頭的情況下接受請求。在添加了表明請求訊息體長度的有效 Content-Length 頭之後,客戶端可以再次提交該請求。
412 伺服器在驗證在請求的頭欄位中給出先決條件時,沒能滿足其中的一個或多個。這個狀態碼允許客戶端在獲取資源時在請求的元資訊(請求頭欄位資料)中設定先決條件,以此避免該請求方法被應用到其希望的內容以外的資源上。
413 伺服器拒絕處理當前請求,因為該請求提交的實體資料大小超過了伺服器願意或者能夠處理的範圍。此種情況下,伺服器可以關閉連線以免客戶端繼續傳送此請求。 如果這個狀況是臨時的,伺服器應當返回一個 Retry-After 的響應頭,以告知客戶端可以在多少時間以後重新嘗試。
414 請求的URI 長度超過了伺服器能夠解釋的長度,因此伺服器拒絕對該請求提供服務。這比較少見,通常的情況包括: 本應使用POST方法的表單提交變成了GET方法,導致查詢字串(Query String)過長。 重定向URI “黑洞”,例如每次重定向把舊的 URI 作為新的 URI 的一部分,導致在若干次重定向後 URI 超長。 客戶端正在嘗試利用某些伺服器中存在的安全漏洞攻擊伺服器。這類伺服器使用固定長度的緩衝讀取或操作請求的 URI,當 GET 後的引數超過某個數值後,可能會產生緩衝區溢位,導致任意程式碼被執行[1]。沒有此類漏洞的伺服器,應當返回414狀態碼。
415 對於當前請求的方法和所請求的資源,請求中提交的實體並不是伺服器中所支援的格式,因此請求被拒絕。
416 如果請求中包含了 Range 請求頭,並且 Range 中指定的任何資料範圍都與當前資源的可用範圍不重合,同時請求中又沒有定義 If-Range 請求頭,那麼伺服器就應當返回416狀態碼。 假如 Range 使用的是位元組範圍,那麼這種情況就是指請求指定的所有資料範圍的首位元組位置都超過了當前資源的長度。伺服器也應當在返回416狀態碼的同時,包含一個 Content-Range 實體頭,用以指明當前資源的長度。這個響應也被禁止使用 multipart/byteranges 作為其 Content-Type。
417 在請求頭 Expect 中指定的預期內容無法被伺服器滿足,或者這個伺服器是一個代理伺服器,它有明顯的證據證明在當前路由的下一個節點上,Expect 的內容無法被滿足。
421 從當前客戶端所在的IP地址到伺服器的連線數超過了伺服器許可的最大範圍。通常,這裡的IP地址指的是從伺服器上看到的客戶端地址(比如使用者的閘道器或者代理伺服器地址)。在這種情況下,連線數的計算可能涉及到不止一個終端使用者。
422 從當前客戶端所在的IP地址到伺服器的連線數超過了伺服器許可的最大範圍。通常,這裡的IP地址指的是從伺服器上看到的客戶端地址(比如使用者的閘道器或者代理伺服器地址)。在這種情況下,連線數的計算可能涉及到不止一個終端使用者。
422 請求格式正確,但是由於含有語義錯誤,無法響應。(RFC 4918 WebDAV)423 Locked 當前資源被鎖定。(RFC 4918 WebDAV)
424 由於之前的某個請求發生的錯誤,導致當前請求失敗,例如 PROPPATCH。(RFC 4918 WebDAV)
425 在WebDav Advanced Collections 草案中定義,但是未出現在《WebDAV 順序集協議》(RFC 3658)中。
426 客戶端應當切換到TLS/1.0。(RFC 2817)
449 由微軟擴充套件,代表請求應當在執行完適當的操作後進行重試。
500 伺服器遇到了一個未曾預料的狀況,導致了它無法完成對請求的處理。一般來說,這個問題都會在伺服器的程式碼出錯時出現。
501 伺服器不支援當前請求所需要的某個功能。當伺服器無法識別請求的方法,並且無法支援其對任何資源的請求。
502 作為閘道器或者代理工作的伺服器嘗試執行請求時,從上游伺服器接收到無效的響應。
503 由於臨時的伺服器維護或者過載,伺服器當前無法處理請求。這個狀況是臨時的,並且將在一段時間以後恢復。如果能夠預計延遲時間,那麼響應中可以包含一個 Retry-After 頭用以標明這個延遲時間。如果沒有給出這個 Retry-After 資訊,那麼客戶端應當以處理500響應的方式處理它。 注意:503狀態碼的存在並不意味著伺服器在過載的時候必須使用它。某些伺服器只不過是希望拒絕客戶端的連線。
504 作為閘道器或者代理工作的伺服器嘗試執行請求時,未能及時從上游伺服器(URI標識出的伺服器,例如HTTP、FTP、LDAP)或者輔助伺服器(例如DNS)收到響應。 注意:某些代理伺服器在DNS查詢超時時會返回400或者500錯誤
505 伺服器不支援,或者拒絕支援在請求中使用的 HTTP 版本。這暗示著伺服器不能或不願使用與客戶端相同的版本。響應中應當包含一個描述了為何版本不被支援以及伺服器支援哪些協議的實體。
506 由《透明內容協商協議》(RFC 2295)擴充套件,代表伺服器存在內部配置錯誤:被請求的協商變元資源被配置為在透明內容協商中使用自己,因此在一個協商處理中不是一個合適的重點。
507 伺服器無法儲存完成請求所必須的內容。這個狀況被認為是臨時的。WebDAV (RFC 4918)
509 伺服器達到頻寬限制。這不是一個官方的狀態碼,但是仍被廣泛使用。
510 獲取資源所需要的策略並沒有沒滿足。(RFC 2774)