意味
過負荷やメンテナンスのため、サーバーは一時的にリクエストを処理できません。Retry-After で再試行の時期が示されることがあります。
よくある原因
- 計画メンテナンス
- サーバーの過負荷やワーカー不足
- オートスケールが追いつかない、または依存先の障害
対処法
クライアント・閲覧者の場合
Retry-After に従って後で再試行します。
サイトや API の運営者の場合
メンテナンス中は Retry-After を送り、容量を増やし、負荷を穏やかに落とします。検索エンジンは短い 503 を一時的なものとして扱います。
レスポンス例
HTTP/1.1
HTTP/1.1 503 Service Unavailable
Date: Tue, 07 Oct 2025 09:30:00 GMT
Server: nginx
Retry-After: 120
Content-Type: application/problem+json
{
"type": "about:blank",
"title": "Service Unavailable",
"status": 503,
"detail": "Down for maintenance until 02:00 UTC."
}仕様
よくある質問
› メンテナンスページに 503 は適切？
はい。Retry-After 付きで 503 を返すと、検索エンジンはページを消えたと見なさずインデックスを保ちます。
› 503 と 500 の違いは？
503 は停止が一時的で回復が見込まれることを、500 は予期しない障害を示します。