第4章 返回結(jié)果的 HTTP 狀態(tài)碼

4.1 狀態(tài)碼告知從服務(wù)器端返回的請(qǐng)求結(jié)果

狀態(tài)碼的職責(zé)是當(dāng)客戶端向服務(wù)器端發(fā)送請(qǐng)求時(shí)，描述返回的請(qǐng)求 結(jié)果龄毡。借助狀態(tài)碼吠卷，用戶可以知道服務(wù)器端是正常處理了請(qǐng)求，還是出現(xiàn)了錯(cuò)誤稚虎。

4.2 2XX 成功

2XX 的響應(yīng)結(jié)果表明請(qǐng)求被正常處理了撤嫩。

4.2.1 200 OK（請(qǐng)求成功，正常處理）

表示從客戶端發(fā)來的請(qǐng)求在服務(wù)器端被正常處理了蠢终。
在響應(yīng)報(bào)文內(nèi)序攘，隨狀態(tài)碼一起返回的信息會(huì)因方法的不同而發(fā)生改 變。比如寻拂，使用 GET 方法時(shí)程奠，對(duì)應(yīng)請(qǐng)求資源的實(shí)體會(huì)作為響應(yīng)返回; 而使用 HEAD 方法時(shí)，對(duì)應(yīng)請(qǐng)求資源的實(shí)體首部不隨報(bào)文主體作為響 應(yīng)返回(即在響應(yīng)中只返回首部祭钉，不會(huì)返回實(shí)體的主體部分)瞄沙。

4.2.2 204 No Content（請(qǐng)求成功，正常處理返回的響應(yīng)報(bào)文中不含實(shí)體的主體部分）

該狀態(tài)碼代表服務(wù)器接收的請(qǐng)求已成功處理慌核，但在返回的響應(yīng)報(bào)文中不含實(shí)體的主體部分距境。另外，也不允許返回任何實(shí)體的主體垮卓。比如垫桂，當(dāng)從瀏覽器發(fā)出請(qǐng)求處理后，返回 204 響應(yīng)粟按，那么瀏覽器顯示的頁面不發(fā)生更新诬滩。
PUT 和 DELETE 方法會(huì)返回204霹粥。
一般在只需要從客戶端往服務(wù)器發(fā)送信息，而對(duì)客戶端不需要發(fā)送新信息內(nèi)容的情況下使用疼鸟。

4.2.3 206 Partial Content（范圍請(qǐng)求）

該狀態(tài)碼表示客戶端進(jìn)行了范圍請(qǐng)求（使用首部字段 Range 來指定資源的 byte 范圍）后控，而服務(wù)器成功執(zhí)行了這部分 的 GET 請(qǐng)求。響應(yīng)報(bào)文中包含由 Content-Range 指定范圍的實(shí)體內(nèi)容空镜。

4.3 3XX 重定向

3XX 響應(yīng)結(jié)果表明瀏覽器需要執(zhí)行某些特殊的處理以正確處理請(qǐng)求浩淘。

4.3.1 301 Moved Permanently（永久性重定向）

永久性重定向。該狀態(tài)碼表示請(qǐng)求的資源已被分配了新的 URI姑裂，以后應(yīng)使用資源現(xiàn)在所指的 URI馋袜。也就是說，如果已經(jīng)把資源對(duì)應(yīng)的 URI 保存為書簽了舶斧，這時(shí)應(yīng)該按 Location 首部字段提示的 URI 重新保存欣鳖。

4.3.2 302 Found（臨時(shí)性重定向）

臨時(shí)性重定向。該狀態(tài)碼表示請(qǐng)求的資源已被分配了新的 URI茴厉，希望用戶(本次)能使用新的 URI 訪問泽台。
和 301 Moved Permanently 狀態(tài)碼相似，但 302 狀態(tài)碼代表的資源 不是被永久移動(dòng)矾缓，只是臨時(shí)性質(zhì)的怀酷。換句話說，已移動(dòng)的資源對(duì)應(yīng)的 URI 將來還有可能發(fā)生改變嗜闻。比如蜕依，用戶把 URI 保存成書簽，但不會(huì)像 301 狀態(tài)碼出現(xiàn)時(shí)那樣去更新書簽琉雳，而是仍舊保留返回 302 狀態(tài)碼的頁 面對(duì)應(yīng)的 URI样眠。

4.3.3 303 See Other（類似302，但使用 GET 方法重定向獲取請(qǐng)求的資源）

該狀態(tài)碼表示由于請(qǐng)求對(duì)應(yīng)的資源存在著另一個(gè) URI翠肘，應(yīng)使用 GET 方法定向獲取請(qǐng)求的資源檐束。
303 狀態(tài)碼和 302 Found 狀態(tài)碼有著相同的功能，但 303 狀態(tài)碼明確表示客戶端應(yīng)當(dāng)采用 GET 方法獲取資源束倍，這點(diǎn)與 302 狀態(tài)碼有區(qū)別被丧。
比如，當(dāng)使用 POST 方法訪問 CGI 程序绪妹，其執(zhí)行后的處理結(jié)果是希 望客戶端能以 GET 方法重定向到另一個(gè) URI 上去時(shí)甥桂，返回 303 狀態(tài)碼。 雖然 302 Found 狀態(tài)碼也可以實(shí)現(xiàn)相同的功能邮旷，但這里使用 303 狀態(tài)碼是最理想的格嘁。

4.3.4 304 Not Modified（緩存相關(guān)）

該狀態(tài)碼表示客戶端發(fā)送附帶條件的請(qǐng)求時(shí)（附帶條件的請(qǐng)求是指采用 GET 方法的請(qǐng)求報(bào)文中包含 If-Match，If-Modified- Since廊移，If-None-Match糕簿，If-Range，If-Unmodified-Since 中任一首部）狡孔，服務(wù)器端允許請(qǐng)求訪問資源懂诗，但未滿足條件的情況。304 狀態(tài)碼返回時(shí)苗膝，不包含任何響應(yīng)的主體部分殃恒。304 雖然被劃分在 3XX 類別中，但是和重定向沒有關(guān)系辱揭。

307 Temporary Redirect（與302相同）

臨時(shí)重定向离唐。該狀態(tài)碼與 302 Found 有著相同的含義。盡管 302 標(biāo)準(zhǔn)禁止 POST 變換成 GET问窃，但實(shí)際使用時(shí)大家并不遵守亥鬓。
307 會(huì)遵照瀏覽器標(biāo)準(zhǔn)，不會(huì)從 POST 變成 GET域庇。但是嵌戈，對(duì)于處理響應(yīng)時(shí)的行為，每種瀏覽器有可能出現(xiàn)不同的情況听皿。

4.4 4XX 客戶端錯(cuò)誤

4XX 的響應(yīng)結(jié)果表明客戶端是發(fā)生錯(cuò)誤的原因所在熟呛。

4.4.1 400 Bad Request（請(qǐng)求報(bào)文存在語法錯(cuò)誤）

該狀態(tài)碼表示請(qǐng)求報(bào)文中存在語法錯(cuò)誤。當(dāng)錯(cuò)誤發(fā)生時(shí)尉姨，需修改請(qǐng)求 的內(nèi)容后再次發(fā)送請(qǐng)求庵朝。另外，瀏覽器會(huì)像 200 OK 一樣對(duì)待該狀態(tài)碼又厉。

4.4.2 401 Unauthorized（身份認(rèn)證）

該狀態(tài)碼表示發(fā)送的請(qǐng)求需要有通過 HTTP 認(rèn)證(BASIC 認(rèn)證九府、 DIGEST 認(rèn)證)的認(rèn)證信息。另外若之前已進(jìn)行過 1 次請(qǐng)求馋没，則表示用 戶認(rèn)證失敗昔逗。
返回含有 401 的響應(yīng)必須包含一個(gè)適用于被請(qǐng)求資源的 WWW- Authenticate 首部用以質(zhì)詢(challenge)用戶信息。當(dāng)瀏覽器初次接收 到 401 響應(yīng)篷朵，會(huì)彈出認(rèn)證用的對(duì)話窗口勾怒。

4.4.3 403 Forbidden（未授權(quán)）

該狀態(tài)碼表明對(duì)請(qǐng)求資源的訪問被服務(wù)器拒絕了。服務(wù)器端沒有必 要給出拒絕的詳細(xì)理由声旺，但如果想作說明的話笔链，可以在實(shí)體的主體部分 對(duì)原因進(jìn)行描述，這樣就能讓用戶看到了腮猖。
未獲得文件系統(tǒng)的訪問授權(quán)鉴扫，訪問權(quán)限出現(xiàn)某些問題(從未授權(quán)的 發(fā)送源 IP 地址試圖訪問)等列舉的情況都可能是發(fā)生 403 的原因。

4.4.4 404 Not Found（服務(wù)器上無法找到請(qǐng)求的資源）

該狀態(tài)碼表明服務(wù)器上無法找到請(qǐng)求的資源澈缺。除此之外坪创，也可以在服務(wù)器端拒絕請(qǐng)求且不想說明理由時(shí)使用炕婶。

4.5 5XX 服務(wù)器錯(cuò)誤

5XX 的響應(yīng)結(jié)果表明服務(wù)器本身發(fā)生錯(cuò)誤。

4.5.1 500 Internal Server Error（服務(wù)器端在執(zhí)行請(qǐng)求時(shí)發(fā)生了錯(cuò)誤）

該狀態(tài)碼表明服務(wù)器端在執(zhí)行請(qǐng)求時(shí)發(fā)生了錯(cuò)誤莱预。也有可能是 Web 應(yīng)用存在的 bug 或某些臨時(shí)的故障柠掂。

4.5.2 503 Service Unavailable（服務(wù)器暫時(shí)處于超負(fù)載或正在進(jìn)行停機(jī)維護(hù)）

該狀態(tài)碼表明服務(wù)器暫時(shí)處于超負(fù)載或正在進(jìn)行停機(jī)維護(hù)，現(xiàn)在無法處理請(qǐng)求依沮。如果事先得知解除以上狀況需要的時(shí)間涯贞，最好寫入 Retry- After 首部字段再返回給客戶端。