每個開發人員都會保留一份 HTTP 狀態代碼的心理候選清單。我的曾經是 200、404 和 500,很長一段時間足以偽造能力。然後我花了一周的時間建立支付集成,其中 API 傳回被拒絕的卡的 402,當我重試已經完成的收費時傳回 409,當我的測試敲擊得太快時傳回 429。突然間,程式碼之間的差異就是工作功能和支援票之間的差異。我為此建立了很多網路工具 工具。dev,可搜尋的狀態代碼參考是我不斷追求的目標之一,因此我在網站中建立了一個並編寫了本指南來配合它。
TL;DR: HTTP 狀態代碼是伺服器發回來描述請求結果的三位數。第一位數字設定類別:1xx 資訊、2xx 成功、3xx 重定向、4xx 用戶端錯誤、5xx 伺服器錯誤。立即查找其中任何一個 HTTP 狀態代碼工具,它允許您按數字、名稱或關鍵字進行搜索,並引用定義每個 RFC 的 RFC。
本指南介紹了狀態代碼是什麼、每個類別的含義、值得記住的特定代碼以及人們最常犯錯的代碼。它針對的是前端開發人員調試 API 呼叫、後端開發人員決定返回什麼以及任何需要重定向才能執行行為的技術 SEO。
什麼是 HTTP 狀態代碼?
每次您的瀏覽器或應用程式透過網路請求某些內容時,伺服器都會回應。該回應的第一行包含一個狀態代碼:一個三位數的數字,搭配一個簡短的原因短語,例如 "OK"或"未找到並引用;。該程式碼是機器可讀的所發生事件的摘要,原因短語是人性化的標籤。客戶對號碼採取行動;該短語適用於閱讀日誌的人。
狀態代碼由互聯網工程任務組定義,主要在 RFC 9110 中定義,該任務組於 2022 年整合了舊的 HTTP 規範。IANA 維護的中央註冊表列出了每個官方認可的代碼。這種標準化使一家公司編寫的瀏覽器能夠與另一家公司編寫的伺服器通話,並就 404 的含義達成一致。這 HTTP 狀態代碼工具 反映該註冊表,列出每個標準代碼及其含義以及定義它的 RFC。
關鍵的心理模型是,第一個數字告訴你類別,類別告訴你誰負責。 4xx 代碼表示客戶端發送了錯誤訊息。 5xx 代碼表示伺服器在請求失敗時失敗。這種單一區別解決了大多數關於它是誰的錯誤的調試參數。
五個狀態代碼類別是什麼意思?
正好有五個類別,按前導數字分組。了解課程比記住各個程式碼更有價值,因為它可以告訴您去哪裡查看。
1xx 類別是資訊性的。這些代碼表示伺服器收到了請求並且處理仍在繼續。它們在日常工作中很少見。最著名的是 100 繼續,最有用的現代提示是 103 早期提示,它允許伺服器告訴瀏覽器在完整回應準備好之前開始預載資源。
2xx 類別意味著成功。請求已收到、理解並接受。 200 OK 是日常成功代碼,201 建立確認已建立新資源,204 無內容說 "完成,無需發回",這對於刪除操作來說很常見。
3xx 類別是重定向。資源位於其他地方,或自客戶端上次看到它以來沒有改變。此類別是 SEO 所在的位置,因為 301 和 302 告訴搜尋引擎移動是否是永久性的。 304 Not Modified 是一個快取主力,可以節省大量頻寬。
4xx 類別是客戶端錯誤。該請求格式錯誤、未經授權或指向不存在的內容。 400、401、403、404 和 429 都住在這裡。當您看到 4xx 時,請在責怪伺服器之前檢查發送的程式碼。
5xx 類別是伺服器錯誤。該請求有效,但伺服器無法滿足它。 500、502、503 和 504 是您在生產事件中遇到的情況,通常指向崩潰、服務過載或上游依賴關係損壞。
每個開發人員都應該知道哪些 HTTP 狀態代碼?
你不需要腦子裡有全部六十多個代碼。你可能需要十五,剩下的你抬頭看看。我認為,這就是工作集,它會在記憶中贏得永久的位置,以及觸發它們的情況。
| 代碼 | 意義 | 當你看到它 |
|---|---|---|
| 200 | 好的 | 正常的成功請求 |
| 201 | 創建 | POST 或 PUT 製作了新資源 |
| 204 | 沒有內容 | 空體成功,刪除後常見 |
| 301 | 永久移動 | URL 永久移動; SEO排名轉移 |
| 302 | 找到了 | 臨時重定向;繼續使用舊 URL |
| 304 | 未修改 | 快取副本仍然有效;沒有發送任何屍體 |
| 400 | 糟糕的請求 | 語法格式錯誤或請求框架無效 |
| 401 | 未經授權 | 身份驗證遺失或失敗 |
| 403 | 禁止 | 已驗證但不允許 |
| 404 | 未找到 | 該資源不存在 |
| 409 | 衝突 | 該請求與當前狀態發生衝突 |
| 第422章 | 無法處理的內容 | 語法有效,驗證規則失敗 |
| 第429章 | 請求太多 | 速率有限;退後並重試 |
| 500 | 內部伺服器錯誤 | 意想不到的伺服器故障 |
| 503 | 服務不可用 | 伺服器過載或正在維護 |
註冊表的其餘部分,從 226 IM 二手到 451 因法律原因不可用,值得識別但不記住。這正是查找工具的用途。
401和403有什麼差別?
這對幾乎會絆倒所有人,所以它值得擁有自己的部分。這兩種意味著訪問都被拒絕,但出於不同的原因,並且差異改變了您的應用程式應該如何回應。
401 未經授權意味著該請求缺乏有效的身份驗證。伺服器不知道您是誰。您沒有發送任何憑證,或者您發送的憑證錯誤或過期。您方面的正確回應是登入或刷新令牌。根據規範,401 回應應包括 WWW-Authenticate 標頭,告訴客戶端如何進行身份驗證。
403 禁止意味著伺服器確切地知道您是誰並且無論如何都拒絕。您已通過身份驗證,但未獲得此特定資源的授權。再次登入無濟於事,因為問題是權限,而不是身分。普通用戶點擊僅限管理員的端點應該會得到 403。
我使用的快速規則:401 是 "你是誰?",403 是 "我知道你是誰,不 "。如果您正在建立 API 並想要產生授權標頭來測試這些流,則 基本 Auth 產生器 產生您需要編碼的憑證。
為什麼 301 與 302 重定向對 SEO 很重要?
重定向是指狀態代碼不再是內部實作細節並開始影響您的搜尋排名。當您移動頁面時,您傳回的狀態代碼會告訴搜尋引擎如何處理舊的 URL's 累積的權限。
301 Moved Permanently 表示該移動是最終的。隨著時間的推移,搜尋引擎會從索引中刪除舊 URL,將排名訊號傳遞到新 URL,並更新其連結。這是您重新命名頁面、遷移到 HTTPS 或合併重複 URL 時想要的程式碼。正確使用它是技術 SEO 審核中最常見的修復方法之一。
302 Found 標誌著臨時搬遷。搜尋引擎保留原始 URL 索引,因為您已告訴他們更改不是永久性的。如果您使用 302 進行永久移動,您可以將排名擱淺在不再使用的 URL 上。我已經看到網站失去了可見性好幾個月了,因為在 HTTPS 遷移期間框架預設為 302 重定向。
還有 307 個臨時重定向和 308 個永久重定向,它們的行為類似於 302 和 301,但保證保留 HTTP 方法和正文。對於非 GET 請求,使用 307 和 308,更改方法會破壞內容。如果您正在審核爬蟲如何查看您的網站,請將此知識與 robots.txt 產生器 和 元標記產生器 確保整個爬行和重定向圖片一致。這 web 開發人員工具包 指南將這些部件連接在一起。
最常見的伺服器錯誤代碼是什麼以及如何調試它們?
5xx 類別是生產事件所在的位置,每個程式碼都向您指向堆疊的不同層。知道哪一個可以在中斷期間節省即時時間。
500 內部伺服器錯誤是通用的包羅萬象。這意味著您的應用程式程式碼拋出了未處理的異常或遇到了無法處理的條件。修復幾乎總是在您自己的日誌中。 500 是伺服器說 "有東西壞了,我沒有更好的詞來形容它"所以程式碼告訴你去哪裡尋找,但沒有告訴你出了什麼問題。
502 Bad Gateway 和 504 Gateway Timeout 都來自充當網關或代理的伺服器,例如應用程式前面的負載平衡器或反向代理。 502 表示上游發送回無效內容,通常是因為您的應用程式崩潰或未運行。 504 表示上游回應時間過長且網關放棄等待。如果您在 Nginx、CDN 或雲端負載平衡器後面運行,這些是當代理背後的內容不健康時您將看到的程式碼。
503 服務不可用意味著伺服器暫時無法處理該請求,通常是因為它超載或處於維護狀態。表現良好的 503 回應包括 Retry-After 標頭,告訴客戶端何時返回。在計劃維護期間發送 503 是短暫關閉網站的正確、SEO 安全方式,因為它告訴搜尋引擎稍後返回,而不是假設頁面已消失。為了更廣泛地了解診斷 Web 問題, 開發人員生產力工具 指南涵蓋了更廣泛的工具包。
不太常見的狀態代碼呢?
除了工作集之外,註冊表還保存著您偶爾會遇到的一長串代碼,識別它們可以節省混亂的半小時。有些值得快速遊覽。
在 2xx 系列中,206 部分內容支援可恢復下載和視訊串流。當客戶端發送請求檔案位元組 500 到 999 的範圍標頭時,伺服器僅用該切片回答 206。這就是暫停下載如何恢復而不是重新開始,以及瀏覽器如何在不先獲取整個內容的情況下尋找影片的中間。
在 4xx 系列中,410 Gone 是 404 的更強大、更刻意的版本。其中 404 說 "我找不到它",410 說"它就在這裡,它永久消失了,停止詢問"。另一個有用的是 451 因法律原因不可用,其編號是對小說《華氏 451 度》的致敬,當內容被刪除或法院禁令等法律命令阻止時,它會返回。
還有 418 I'm a Teapot,這是 1998 年愚人節規範中的真實註冊代碼,當被要求沖泡咖啡時,茶壺會返回。它不用於正常交通,但在某些 API 中顯示為復活節彩蛋,這只是提醒您編寫這些標準的人有幽默感。該工具列出了所有這些,以便您可以查找任何您偶然發現的內容而不猜測。
HTTP 狀態代碼工具有何幫助?
這個工具故意很簡單,因為工作很簡單:你有一個程式碼或一個症狀,你想要快速理解其中的含義。您可以按數字、原因短語(如 ")進行搜尋;未找到並引用;,或透過描述中的關鍵字(如 "redirect"或 "rate limited")進行搜尋。您可以過濾到單一類別以僅瀏覽重定向或伺服器錯誤。每個條目都顯示原因短語、程式碼何時適用的簡單解釋以及定義它的 RFC,以便您可以確認針對主要來源的行為。
由於整個註冊表都載入到您的瀏覽器中,因此搜尋是即時的,並且一旦頁面打開即可離線工作。您搜尋的任何內容都不會發送到任何地方。這是我在建立 API 時固定在選項卡中的參考,就在旁邊 用戶代理解析器 用於檢查請求標頭。
常見問題
HTTP 狀態碼有五類?
HTTP 狀態代碼按第一位數字分組:1xx 資訊、2xx 成功、3xx 重定向、4xx 用戶端錯誤和 5xx 伺服器錯誤。該類別一目了然地告訴您請求在客戶端或伺服器端是否成功、被重定向或失敗,這通常足以知道從哪裡開始調試。
404 狀態代碼是什麼意思?
404 未找到表示伺服器無法找到所要求的資源。 URL 可能會拼字錯誤、頁面可能已被刪除或連結可能被破壞。它是一個客戶端錯誤代碼,因此請求到達伺服器,但指向那裡不存在的東西。
301 和 302 重定向有什麼不同？
301 Moved Permanently 告訴客戶端和搜尋引擎資源已永久移動,因此他們更新連結並將排名訊號傳輸到新 URL。 302 Found 是一個臨時重定向,因此原始 URL 應繼續用於未來的請求,並且搜尋引擎應將其保留為索引。
500 內部伺服器錯誤意味著什麼?
500 內部伺服器錯誤是一則通用訊息,表示伺服器遇到了無法處理的意外情況。它向伺服器上的問題而不是請求發出信號,因此修復通常位於應用程式程式碼或配置中,您自己的伺服器日誌是查看的地方。
API 應該何時傳回 400 與 422?
當請求本身格式錯誤時,例如 JSON 無效或缺少所需的標頭,則傳回 400 Bad Request。當語法有效但資料不符合業務或驗證規則(例如已取得的電子郵件或超出範圍的值)時,傳回 422 無法處理的內容。
什麼是 429 請求太多代碼?
429 請求太多意味著客戶端在短時間內發送了太多請求並且受到速率限制。回應通常包括一個重試後標頭,告訴客戶端需要等待多長時間才能再次嘗試,而表現良好的客戶端則透過指數退避來尊重它。
HTTP 狀態代碼參考可以免費使用嗎?
是的。該工具是完全免費的,沒有註冊,也沒有限制,一旦頁面加載,它就可以離線工作,因為整個清單都在您的瀏覽器中運行。您搜尋的任何內容都不會發送到伺服器,因此在調試時使用它是安全且快速的。
