【入門編】HTTP/2エラーコード(PROTOCOL_ERROR等)の定義と意味 – HTTPプロトコル・通信規格実践ガイド

ウェブブラウザでサイトを見ているとき、画像が一気に読み込まれたり、サクサクとページが切り替わったりするのを感じたことはありませんか？その裏側を支えている主役の一つが「HTTP/2」です。

HTTP/2の大きな魅力は、1本の通信の通り道（コネクション）の中で、いくつものデータを同時に、まるでパズルのように効率よくやり取りできる「マルチプレクシング（多重化）」という仕組みにあります。

でも、たくさんのデータが同時に行き交うということは、それだけ交通整理が難しくなるということでもありますよね。「あ、今のデータ順序がめちゃくちゃだよ！」「ちょっと通信をストップして！」といった、現場での緊急連絡が必要になる場面も出てきます。

そんなときに登場するのが、今回スポットを当てる「HTTP/2エラーコード」です。

「エラーコード」と聞くと、なんだか難しそう……と感じてしまうかもしれませんが、大丈夫です！一歩ずつ、身近な例えを交えながら優しく紐解いていきましょう。

—

郵便配達で例えるHTTP/2の世界

HTTP/2の通信をイメージしやすくするために、身近な「郵便配達」に置き換えて考えてみましょう。

あなた（ブラウザ）と、遠くの倉庫（Webサーバー）の間には、大きな1本の「専用道路」がつながっています。HTTP/1.1という昔のやり方では、この道路を「1回につき1通の手紙しか運べない台車」が往復していました。これでは、たくさんの荷物を送るのに時間がかかってしまいますよね。

そこでHTTP/2では、この1本の道路を複数のレーンに区切り、いくつもの荷物（ストリームと呼びます）を同時に走らせることにしました。

ここで、こんなハプニングが起きたと想像してください。

倉庫から届いた荷物の宛先ラベルが破れていて、どこに行けばいいか分からない！
道路の交通ルールを破るような、おかしな荷物が送りつけられてきた！

こんなとき、配達員はどうするでしょうか。「おいおい、この荷物は危ないから一度引っ込めてくれ！」「このレーンは一旦閉鎖だ！」と、現場の責任者に大声で伝えますよね。

この「緊急停止の合図」や「トラブルの原因を伝える共通言語」こそが、HTTP/2のエラーコードなのです。

—

代表的なHTTP/2エラーコードたち

HTTP/2（RFC 7540）では、通信の途中で何らかの問題が発生した際、相手にその理由を伝えるための「お叱りコード（エラーコード）」がいくつか用意されています。

特に現場でよく見かける代表的なものを、優しく翻訳して見ていきましょう。

1. PROTOCOL_ERROR（プロトコルエラー）

意味: 「交通ルール違反です！」
どんなときに出る？: HTTP/2の基本的なお約束（ルールの順番や、データの送り方の作法など）を、クライアントまたはサーバーのどちらかが破ってしまったときに発生します。「えっ、今そこ曲がっちゃダメでしょ！」というような、ルール無視の通信が検知されたときの一般的なエラーです。

2. INTERNAL_ERROR（内部エラー）

意味: 「サーバーの内部でプチパニックが起きました……」
どんなときに出る？: 通信のルール自体は間違っていないのに、サーバー側のプログラムがバグを起こしたり、データベースが急に重くなったりして、予期せぬプッツン状態になってしまったときです。

3. FLOW_CONTROL_ERROR（フロー制御エラー）

意味: 「荷物を送りすぎてパンク寸前です！」
どんなときに出る？: HTTP/2には、受け取る側の処理能力を超えてデータが届かないように「これ以上送っちゃダメだよ」とブレーキを踏む仕組み（フロー制御）があります。このブレーキの約束事を無視して、我が物顔でデータを送りつけてしまったときに発生します。

4. REFUSED_STREAM（拒絶されたストリーム）

意味: 「その荷物のレーンは、今回は受け付けられません！」
どんなときに出る？: まだ何もデータを処理していない綺麗な状態のストリーム（レーン）に対して、「やっぱりこの処理はやーめた」とサーバーが安全に拒否したときに使われます。リトライが可能な優しいエラーでもあります。

—

エラーを伝える2つのメッセージ（RST_STREAM と GOAWAY）

これらのエラーコードは、ただ単独で宙に浮いているわけではありません。実際にパケットを流す際には、主に次の2つのどちらかの命令（フレーム）に乗せて相手に届けられます。

1. RST_STREAM（リセットストリーム）

イメージ: 「特定のレーンだけ、今すぐリセット（中断）して！」
特徴: 1本の道路の中の、特定の荷物（ストリーム）だけがゴタゴタしたときに使います。他の元気な荷物はそのまま配達を続けられます。

2. GOAWAY（ゴーアウェイ）

イメージ: 「この道路全体のやり取りはここまで！一度おしまい！」
特徴: コネクション（道路そのもの）を丸ごと切断しなければならないような、重大なトラブルやメンテナンスのときに使われます。「これ以上新しい荷物は作らないで、今ある分が終わったら店じまいしましょうね」というお片付けの合図です。

—

実務やデバッグで遭遇したときのハンドリング方法

インフラエンジニアや開発者として現場に立っていると、ブラウザのコンソール画面や、プロキシサーバー（NginxやEnvoyなど）のログで、こうしたエラーコードに直面することがあります。

「うわ、エラーが出たどうしよう……」と焦ってしまいますが、以下のステップで冷静に切り分けていきましょう。

1. ログやパケットキャプチャでエラーコードを特定する

まずは、どのエラーコードが出ているのかを確認します。例えば、Nginxのエラーログであれば、以下のようなメッセージが記録されることがあります。

例: NginxのログにHTTP/2のエラーが記録された場合のイメージ
2023/10/25 10:00:00 [info] 12345#12345: 100 http2 process request header error (1: PROTOCOL_ERROR) while reading client request headers

このように、`PROTOCOL_ERROR` なのか `INTERNAL_ERROR` なのかが分かれば、原因の当たりをグッとつけやすくなります。

2. クライアント側（ブラウザやアプリ）の不具合を疑う

もし `PROTOCOL_ERROR` が頻発する場合、アクセスしているクライアント側のHTTP/2実装（古いブラウザや、一昔前の独自クライアントアプリなど）が、仕様に厳密ではないリクエストを送っている可能性があります。

対応策: クライアント側のライブラリを最新バージョンにアップデートする、あるいは中間にあるリバースプロキシのバージョンを見直すことで解決することがよくあります。

3. プロキシやロードバランサーの設定を見直す

HTTP/2はTLS（暗号化通信）の上で動くことが多いため、SSL証明書の設定や、HTTP/2のバッファサイズ、タイムアウト設定がシビアに影響します。
例えば、Nginxであれば設定ファイルで以下のようなパラメータを調整することがあります。

NginxにおけるHTTP/2関連の設定例
http {
# HTTP/2の接続において、一度に受け付けるストリームの最大数などを調整
http2_max_concurrent_streams 128;

# 読み取りバッファのサイズを適切に設定し、フロー制御のトラブルを防ぐ
http2_recv_buffer_size 256k;
}

※実務では、ご利用のサーバー環境や公式ドキュメントを確認しながら、慎重にパラメータを調整してくださいね。

—

まとめ

今回は、HTTP/2のエラーコード（PROTOCOL_ERRORやGOAWAYなど）について、郵便配達の例えを交えながら優しく解説してきました。

HTTP/2エラーコードは、マルチプレクシング（同時並行の通信）という便利な仕組みの中で、トラブルが起きたときに交わされる「緊急連絡の共通言語」であること。
トラブルの規模に応じて、特定の荷物だけを止める RST_STREAM と、道路全体を閉じる GOAWAY が使い分けられていること。
現場で遭遇したときは、ログからエラーコードを読み解き、クライアントの作法やサーバー側の設定を一つずつ確認していくことが大切であること。

一見すると難解なネットワークの仕組みも、裏側で起きているドラマをイメージできれば、怖くありませんよね。日々の開発やインフラ運用のなかでエラーに直面したときは、「あ、今こういう荷物のやり取りで困っているんだな」と思い出してみてください。

それでは、快適なネットワークライフを！