我們都見過那個著名的「404 錯誤」——它就是 HTTP 回應狀態碼的一種。無論是撰寫 AJAX 請求的錯誤處理,還是 debug 跨域請求,讀懂狀態碼都是基本功。
回應的組成
Web 伺服器回應瀏覽器或其他用戶端程式時,答案通常由四部分組成:一個狀態行、若干回應標頭、一個空行、內容文件。
狀態行包含 HTTP 版本、狀態碼,以及對應的簡短說明。除了 Content-Type 之外,絕大多數回應標頭都是選填的;而 Content-Type 是必需的,它描述後面文件的 MIME 類型。雖然大部分回應都帶有文件,但也有例外:對 HEAD 請求的回應永遠不附文件,而許多表示失敗的狀態碼也不帶文件,或只附一段簡短的錯誤說明。
狀態碼的第一位數字代表五大類別:1xx 資訊、2xx 成功、3xx 重新導向、4xx 用戶端錯誤、5xx 伺服器錯誤。
1xx:資訊提示
表示臨時性的回應。用戶端在收到最終回應之前,應準備接收一個或多個 1xx。
- 100 Continue:初始請求已被接受,用戶端應繼續送出其餘部分。(HTTP 1.1 新增)
- 101 Switching Protocols:伺服器將遵從用戶端請求,切換到另一種協定。(HTTP 1.1 新增)
2xx:成功
表示伺服器成功接受並處理了請求。
- 200 OK:一切正常,GET 與 POST 請求的回應文件跟在後面。
- 201 Created:伺服器已建立文件,
Location 標頭給出它的 URL。
- 202 Accepted:請求已接受,但處理尚未完成。
- 203 Non-Authoritative Information:文件已正常回傳,但部分標頭可能不準確,因為這是文件的一份複本。(HTTP 1.1)
- 204 No Content:沒有新文件,瀏覽器應繼續顯示原文件。當使用者定時刷新、而伺服器能確認內容夠新時,這個碼很實用。
- 205 Reset Content:沒有新內容,但瀏覽器應重設目前顯示的內容,常用於強制清除表單輸入。(HTTP 1.1)
- 206 Partial Content:用戶端送出帶有
Range 標頭的 GET 請求,伺服器已完成其中一部分。(HTTP 1.1)
3xx:重新導向
用戶端瀏覽器必須採取更多動作才能完成請求,例如改請求另一個網址,或透過代理伺服器重複送出。
- 300 Multiple Choices:請求的文件可在多個位置找到,已在回應中列出。若伺服器有偏好,應在
Location 標頭指明。
- 301 Moved Permanently:文件已永久搬移,新 URL 在
Location 中給出,瀏覽器應自動前往。
- 302 Found:類似 301,但新 URL 應視為臨時替代。HTTP 1.0 中的訊息寫作「Moved Temporarily」。嚴格來說,只有在原始請求為 GET 時才能假定瀏覽器會自動導向。
- 303 See Other:類似 301/302,差別在於若原始請求是 POST,導向目標應以 GET 取得。(HTTP 1.1)
- 304 Not Modified:用戶端有快取文件並送出條件式請求(通常帶
If-Modified-Since),伺服器告知快取仍可使用。這也是為什麼重新整理頁面有時會「瞬間完成」。
- 305 Use Proxy:請求的文件應透過
Location 所指明的代理伺服器取得。(HTTP 1.1)
- 307 Temporary Redirect:與 302 行為相同,但語意更明確。由於許多瀏覽器對 302 的處理有誤(即使原始請求是 POST 也跟著導向),HTTP 1.1 才新增 307 來區分:303 時 GET 與 POST 都可跟隨導向,307 則只有 GET 會跟隨。(HTTP 1.1)
4xx:用戶端錯誤
出錯了,而且問題似乎出在用戶端——請求了不存在的頁面,或未提出有效的身分驗證。
- 400 Bad Request:請求出現語法錯誤。
- 401 Unauthorized:存取被拒。回應會帶
WWW-Authenticate 標頭,瀏覽器據此顯示帳號密碼對話框。IIS 另有細分:
- 401.1 登入失敗/401.2 伺服器設定導致登入失敗/401.3 因 ACL 限制而未獲授權
- 401.4 篩選器授權失敗/401.5 ISAPI 或 CGI 應用程式授權失敗
- 401.7 存取被 Web 伺服器上的 URL 授權策略拒絕(IIS 6.0 專用)
- 403 Forbidden:資源不可用。伺服器理解請求但拒絕處理,通常源於檔案或目錄的權限設定。IIS 細分項目眾多:
- 403.1 執行存取被禁/403.2 讀取被禁/403.3 寫入被禁
- 403.4 需要 SSL/403.5 需要 SSL 128
- 403.6 IP 位址被拒/403.8 站台存取被拒/403.9 使用者數過多
- 403.10 設定無效/403.11 密碼變更/403.12 拒絕存取對應表
- 403.13 用戶端憑證被吊銷/403.16 憑證不受信任或無效/403.17 憑證已過期或尚未生效
- 403.14 拒絕目錄清單/403.15 超出用戶端存取許可
- 403.18 目前的應用程式集區不能執行所要求的 URL/403.19 不能為此集區中的用戶端執行 CGI/403.20 Passport 登入失敗(以上皆 IIS 6.0 專用)
- 404 Not Found:找不到指定位置的資源,最常見的回應。
- 404.0 找不到檔案或目錄/404.1 無法在所要求的連接埠存取站台
- 404.2 Web 服務延伸鎖定策略阻擋本請求/404.3 MIME 對應策略阻擋本請求
- 405 Method Not Allowed:請求方法(GET、POST、HEAD、DELETE、PUT、TRACE 等)對該資源不適用。(HTTP 1.1)
- 406 Not Acceptable:資源已找到,但其 MIME 類型與用戶端
Accept 標頭不相容。(HTTP 1.1)
- 407 Proxy Authentication Required:需要代理伺服器身分驗證,類似 401。(HTTP 1.1)
- 408 Request Timeout:在伺服器允許的等待時間內,用戶端一直沒有送出請求,稍後可重複。(HTTP 1.1)
- 409 Conflict:通常與 PUT 有關,因請求與資源目前狀態衝突而無法成功。(HTTP 1.1)
- 410 Gone:文件已永久離開該位置,且伺服器不知該導向何處。與 404 的差別是 410 明確表示「永久消失」。(HTTP 1.1)
- 411 Length Required:伺服器無法處理,除非用戶端送出
Content-Length 標頭。(HTTP 1.1)
- 412 Precondition Failed:請求標頭中指定的某些前提條件失敗。(HTTP 1.1)
- 413 Request Entity Too Large:目標文件大小超過伺服器目前願意處理的範圍,必要時應提供
Retry-After。(HTTP 1.1)
- 414 Request URI Too Long:URI 太長。(HTTP 1.1)
- 415 Unsupported Media Type:不支援的媒體類型。
- 416 Requested Range Not Satisfiable:伺服器無法滿足請求中指定的
Range。(HTTP 1.1)
- 417 Expectation Failed:執行失敗。
- 423 Locked:鎖定錯誤。
5xx:伺服器錯誤
伺服器遇到錯誤,無法完成請求。
- 500 Internal Server Error:伺服器遇到意料之外的狀況。IIS 細分:
- 500.12 應用程式正忙於重新啟動/500.13 Web 伺服器太忙
- 500.15 不允許直接請求 Global.asa/500.100 內部 ASP 錯誤
- 500.16 UNC 授權憑證不正確/500.18 URL 授權存放區無法開啟(IIS 6.0 專用)
- 501 Not Implemented:伺服器不支援實作請求所需的功能,例如送出了不支援的 PUT。
- 502 Bad Gateway:伺服器作為閘道或代理時,為了完成請求而存取下一個伺服器,卻收到非法回應。
- 502.1 CGI 應用程式逾時/502.2 CGI 應用程式出錯
- 503 Service Unavailable:服務暫時不可用,通常因維護或負載過重。例如資料庫連接池已滿時可能回傳 503,並附
Retry-After 標頭。
- 504 Gateway Timeout:閘道逾時,表示未能及時從遠端伺服器取得回應。(HTTP 1.1)
- 505 HTTP Version Not Supported:伺服器不支援請求中指明的 HTTP 版本。(HTTP 1.1)
實務上的判讀要點
- 4xx 是自己(用戶端)的問題,5xx 是伺服器的問題。這個分界在 debug 時能快速縮小範圍。
- 301 與 302 不要混用。301 會被瀏覽器與搜尋引擎長期快取,一旦設錯就很難回復;臨時性的搬移請用 302 或 307。
- AJAX 中 304 是正常結果。別把它當成錯誤處理,瀏覽器會自動改用快取內容。
- 401 不等於「密碼錯」。它表示「未通過驗證」,401.1 才是登入失敗;403 則是「驗證身分通過了,但沒有權限」。
- 不要把 200 當成萬靈丹。以 200 搭配本文內的錯誤碼,會讓前端無法用
response.ok 判斷成敗,日誌也難以統計。