503 服務不可用

HTTP 的503 服務不可用 伺服器錯誤響應 狀態碼錶示伺服器未準備好處理請求。

常見原因是伺服器因維護或過載而停機。在維護期間，伺服器管理員可能會暫時將所有流量路由到 503 頁面，或者這可能會在軟體更新期間自動發生。在過載情況下，某些伺服器端應用程式會在達到記憶體、CPU 或連線池限制等資源閾值時，使用 503 狀態拒絕請求。丟棄傳入請求會產生反壓，防止伺服器的計算資源耗盡，避免更嚴重的故障。如果由於速率限制而限制來自特定客戶端的請求，則適當的響應是429 請求過多。

此響應應用於臨時情況，並且如果可能，Retry-After HTTP 標頭應包含服務恢復的預計時間。

應隨此響應一起傳送一個使用者友好的頁面，解釋問題。

注意：隨此響應傳送的與快取相關的標頭需要特別注意；503 表示臨時問題，響應通常不應被快取，因為在修復程式部署後，客戶端可能會收到過時的錯誤頁面。

狀態

http
503 Service Unavailable

示例

503 伺服器錯誤響應

以下請求嘗試獲取網頁，但收到 503 響應。響應正文包含一個描述伺服器狀態的頁面，其中包含指向訪客支援頁面的連結。響應正文中包含一個識別符號，用於說明可能有助於伺服器管理員縮小問題根本原因範圍的方法。

http
GET /highlights HTTP/1.1
Host: example.com
User-Agent: curl/8.6.0
Accept: */*
http
HTTP/1.1 503 Service Unavailable
Content-Type: text/html;
Content-Length: 123

<!doctype html>
<html lang="en">
<head>
  <title>503 Service Unavailable</title>
</head>
<body>
  <h1>503 Service Unavailable</h1>
  <p>The server was unable to complete your request. Please try again later.</p>
  <p>If this problem persists, please <a href="https://example.com/support">contact support</a>.</p>
  <p>Server logs contain details of this error with request ID: ABC-123.</p>
</body>
</html>

規範

規範
HTTP 語義
# status.503

另請參閱