狀態碼是服務器回應的第一行信息,排查問題時的第一手線索。以下按五位分類整理,並附上較完整的中文含義說明。
100 Continue — 繼續
101 Switching Protocols — 切換協議
100 表示客戶端應該繼續發送請求。它通常用於告知客戶端:本次請求已被收到且未被拒絕,可以放心把剩下的數據送出(常見於大檔案上傳前的預檢)。101 則出現在服務器同意透過 Upgrade 頭變更通信協議時。
200 OK — 請求成功
201 Created — 已創建
202 Accepted — 已接受
203 Non-Authoritative Information — 非權威信息
204 No Content — 無內容
205 Reset Content — 重置內容
206 Partial Content — 部分內容
幾個值得留意的含義:201 表示資源已創建,新資源的 URI 通常在 Location 頭中給出,回應體一般包含資源的特性描述。202 表示請求已被接受但尚未處理完成,後續可能被拒絕。204 表示成功但不返回任何實體,常見於 delete 操作。206 配合 Range 請求使用,是分塊下載與多執行緒下載的基礎。
300 Multiple Choices — 多重選擇
301 Moved Permanently — 永久移動
302 Found — 找到
303 See Other — 參見其他
304 Not Modified — 未修改
305 Use Proxy — 使用代理
307 Temporary Redirect — 臨時重定向
301 是永久性的地址變更,搜索引擎會轉移權重;302 是臨時性的,原地址仍然是首選。303 要求客戶端改用 GET 去另一個 URI 取回內容,常用於 POST 之後的跳轉以避免表單重複提交。304 出現在條件式請求命中快取時,回應不含消息體,是緩存機制的核心環節。305 已過時,不建議使用。
400 Bad Request — 請求語法錯誤
401 Unauthorized — 未授權
402 Payment Required — 需要付款
403 Forbidden — 禁止訪問
404 Not Found — 未找到
405 Method Not Allowed — 方法不允許
406 Not Acceptable — 不可接受
407 Proxy Authentication Required — 需要代理驗證
408 Request Timeout — 請求超時
409 Conflict — 衝突
410 Gone — 已永久刪除
411 Length Required — 需要 Content-Length
412 Precondition Failed — 前置條件失敗
413 Request Entity Too Large — 請求實體過大
414 Request-URI Too Long — URI 過長
415 Unsupported Media Type — 不支持的媒體類型
416 Requested Range Not Satisfiable — 請求範圍無法滿足
417 Expectation Failed — 期望失敗
實務中最常遇見的幾個:401 與 403 的區別在於「你是誰」和「你不能」——前者要求身份驗證,後者是身份明確但仍無權限。410 與 404 的差別在於前者明確表示資源已永久刪除,適合告訴搜索引擎不必再來。413 與 414 分別對應上傳體積超限與 URL 長度超限,調試時很常見。
500 Internal Server Error — 內部服務器錯誤
501 Not Implemented — 未實現
502 Bad Gateway — 錯誤網關
503 Service Unavailable — 服務不可用
504 Gateway Timeout — 網關超時
505 HTTP Version Not Supported — 不支持的 HTTP 版本
500 是最泛用的服務端異常,日誌裡通常能找到真實原因。502 表示作為代理/網關的服務器收到了上游的無效回應,常見於後端進程崩潰。503 多在維護或過載時出現,可配合 Retry-After 頭告知客戶端重試時機。504 則是等待上游超時。
首位數字定類別:1 信息、2 成功、3 重定向、4 你把事情搞錯了、5 我把事情搞錯了。排查問題時,先看類別判斷責任方,再看具體碼定位場景,通常一兩分鐘就能鎖定方向。