【入門編】HTTPステータスコード503 Service UnavailableとRetry-Afterヘッダー – HTTPプロトコル・通信規格実践ガイド

ウェブサイトを見ようとしたとき、「503 Service Unavailable」という無機質なエラー画面に出会ったことはありませんか？

「せっかく楽しみにしていたのに！」と少しイラッとする瞬間ですが、実はこれ、サーバーが「今、お客さんが多すぎて対応できないから、少し待っててね！」と、あなたのブラウザに対して誠実にメッセージを送っている状態なんです。

今日は、この「503エラー」の裏側で何が起きているのか、そして「Retry-After」という便利なヘッダーがどうやって通信の交通整理をしているのか、身近な例えを交えて紐解いていきましょう。

—

ネットワークの世界を、街中のレストランに例えてみましょう。

あなたが人気のお店に行くとします。でも、店内はお客さんで溢れかえり、店員さんもパニック状態。これ以上注文を受けると、料理の提供が遅れてお店全体が混乱してしまいますよね。

そんな時、入り口の店員さんがこう言います。
「申し訳ありません、今は満席です。30分後にまた来てください！」

この「満席です（今は無理）」という状態が、HTTPステータスコードの 503 Service Unavailable です。サーバーが一時的に過負荷状態にあるか、メンテナンス中で「今は答えられませんよ」と伝えている状態ですね。

—

ただ、「また後で来て」と言われても、お客さんは困ってしまいますよね。30分後なのか、3時間後なのか、それとも明日なのか。

ここで登場するのが Retry-Afterヘッダー です。

これは、店員さんがあなたに「整理券」を渡すようなものです。そこには「30分後に再開するから、そのタイミングでまた来てね！」という具体的な時間が書かれています。これがあるおかげで、あなたは無駄に何度もドアを開け閉めして確認しなくて済むのです。

ブラウザ（あなた）がサーバーに情報を求めたとき、サーバーは以下のような「手紙」を返します。

HTTP/1.1 503 Service Unavailable
Retry-After: 30
Content-Type: text/html

この `Retry-After: 30` というのが魔法の数字です。
「30秒経ったら、また聞きに来ていいよ」という約束事ですね。これを受け取ったブラウザは、賢いので「じゃあ30秒間は静かに待機しよう」と判断し、無駄なリクエストを送るのを控えてくれます。

—

もしあなたがサーバーを管理する側なら、このヘッダーを適切に設定することで、サーバーの負担を劇的に減らすことができます。設定方法は大きく分けて2つあります。

最も直感的な方法です。「あと何秒待てばいいか」を数字で指定します。

60秒後に再試行してね、という意味
Retry-After: 60

特定の時間まで待ってほしいときは、世界標準の日時（HTTP日付形式）で伝えます。

特定の日時まで待機してね
Retry-After: Wed, 21 Oct 2024 12:00:00 GMT

—

もし、私たちがこの「Retry-After」を使わなかったらどうなるでしょうか。

お客さん（ブラウザ）は「まだかな？まだかな？」と1秒間に何回もドアをノックし続けます。すると、ただでさえ忙しくて倒れそうなレストラン（サーバー）は、ノックに応えるだけで手一杯になり、いつまで経っても料理を作る時間が取れません。これが「アクセス集中によるサーバーダウン」の負のループです。

Retry-Afterは、単なるエラー通知ではなく、「サーバーとクライアントの間の優しい譲り合いの精神」なのです。

こうして見ると、ネットワーク通信も、私たち人間の会話やコミュニケーションと何ら変わりないことがわかりますよね。

インフラの世界は難しく見えがちですが、根底にあるのは「どうすれば効率よく、かつ相手を不快にさせずにデータを届けるか」というシンプルな工夫です。これからも、パケットたちがどんなお喋りをしているのか、少しずつ解き明かしていきましょう！