結論
ERR_HTTP2_PROTOCOL_ERROR は、HTTP/2 の決まりに合わない応答を受け取ったか、応答の途中でストリームを切られたときに Chromium 系のブラウザーが出すエラーです(エラー番号 -337)。まず試すことは3つです。①キャッシュを無視して再読み込み(Windows は Ctrl+Shift+R、Mac は ⌘+Shift+R) ②シークレット ウィンドウで開く ③別の回線・別の端末で開く。どこでも出るならサイト側の問題です。
この記事でわかること
- 見ている人のための最初の5分と、OS別の手順・症状表
- 127.0.0.1 で18通りを再現した Chromium・curl の原文
- 運営側の原因(ヘッダー・途中の切断・プロキシ)と直し方
この記事で実際に動かしたもの:HTTP/2 のフレームを手で組み立てる Python の小さなサーバー(14通りの壊し方)と、nginx 1.24 の中継(4通り)を 127.0.0.1 に立て、Chromium・curl・Node.js で開いてエラーの原文と NetLog を集めました。
ブラウザーは HTTP/2 の応答を点検し、決まりに合わないヘッダーを見つけたとき(大文字・改行など)か、サーバーや中継にストリームを切られたとき(RST_STREAM など)に、このエラーを出します。
flowchart TD
A[応答が届く] --> B{ヘッダーは<br>正しい?}
B -->|いいえ| E[ブラウザーが<br>切る]
B -->|はい| C{本文は<br>最後まで?}
C -->|いいえ| F[サーバーが<br>切った]
C -->|はい| OK[表示]
E --> X[ERR_HTTP2_<br>PROTOCOL_ERROR]
F --> X
よく調べられることの答えを先にまとめます。
| やりたいこと | いちばん早い方法 | 詳しい節 |
|---|---|---|
| ERR_HTTP2_PROTOCOL_ERROR とは何か知りたい | HTTP/2 の決まり違反か、途中の切断。番号は -337 | ERR_HTTP2_PROTOCOL_ERRORとは |
| Chrome で今すぐ直したい | Ctrl+Shift+R → シークレット ウィンドウ → 別の回線 | まず試すこと(最初の5分) |
| 自分だけか、サイト側か知りたい | スマホのモバイル回線など、別の端末・回線で開く | 見ている側の症状表 |
| サイト側の原因を知りたい | 禁止されたヘッダー・途中で切れる応答・大きすぎるヘッダー | 原因1〜4 |
| curl で確かめたい | curl --http2 -v で exit 92 と理由の行を見る |
curl --http2 -v での確かめ方 |
| ブラウザーが切った理由を見たい | chrome://net-export で NetLog を取る | NetLog で理由を見る |
| nginx で出る | error.log の upstream prematurely closed を探す | 原因2・運営側のチェックリスト |
| HTTP/2 を切れば直るか | 表示は戻ることがあるが、原因は残る | 原因4・よくある質問 |
確認環境:Ubuntu 24.04.5 LTS の上で、Python 3.13.18 の socket・ssl だけを使い、HTTP/2 のフレームと HPACK(ヘッダーの圧縮形式)を手で組み立てるサーバーを書きました。127.0.0.1 のポートごとに14通りの応答(一覧は後の表)を返します。中継は nginx 1.24.0(Ubuntu の .deb を作業用のフォルダーに展開したもの)を HTTP/2 と HTTP/1.1 の両方で立て、後ろに置いた HTTP/1.1 の元サーバー(Python)と組み合わせて4通りを試しました。ブラウザーは Playwright 1.63.0 で動かした Chromium 153.0.8010.12(日本語の画面)で、起動時の --log-net-log で NetLog も記録しています。コマンドは curl 8.5.0(nghttp2 1.59.0)、プログラムは Node.js 22.23.4 の node:http2、HPACK の大きさの計算は Python の hpack 4.2.0 です。証明書はその場で作った自己署名のもので、curl は --cacert、Chromium はその証明書の公開鍵だけを信頼する試験用の起動設定で開きました。外部のサイトには接続していません。エラーの定義は Chromium のソース(net/base/net_error_list.h)、HTTP/2 の決まりは RFC 9113、curl の終了コードは curl の公式のエラー一覧、nginx の設定は nginx の公式ドキュメント、Chrome の操作は Chrome の公式ヘルプ、NetLog の取り方は Chromium プロジェクトの案内で確かめました。Windows・Mac・スマホの実機は動かしておらず、その手順は Chrome の公式ヘルプの記載の範囲で書いています(確認日 2026年11月13日)。
本記事の内容は、ご自由にお使いください。
ご利用の際は、出典として本ページへのリンクを記載いただけますようお願いします。
(記載例)出典:株式会社RJC「ERR_HTTP2_PROTOCOL_ERRORの原因と直し方|原因別に再現」
ERR_HTTP2_PROTOCOL_ERRORとは(意味と表示の原文)
この節では、ERR_HTTP2_PROTOCOL_ERROR の意味と、Chromium・curl・Node.js で実際に出た表示の原文が分かります。
ERR_HTTP2_PROTOCOL_ERROR は、Chromium のネットワークのエラー一覧(net_error_list.h)にある HTTP2_PROTOCOL_ERROR(番号 -337)です。ソースの説明は「There is an HTTP/2 protocol error.」の1行だけで、原因はひとつに決まりません。HTTP/2 は、1本の接続の中に「ストリーム」という通り道を何本も作り、ページや画像を並行して運ぶ仕組みです。そのストリームが決まりどおりに終わらなかったとき、まとめてこの番号になります。
手元の Chromium 153(日本語の画面)でページそのものが失敗すると、次の表示になりました。
このサイトにアクセスできません
https://localhost:18731/ のウェブページは一時的に停止しているか、新しいウェブアドレスに移動した可能性があります。
ERR_HTTP2_PROTOCOL_ERROR
画像やスクリプトなど、ページの一部だけが失敗したときは画面にエラーページは出ません。開発者ツールのコンソールに次の1行が出て、その部品だけが欠けます。
Failed to load resource: net::ERR_HTTP2_PROTOCOL_ERROR
JavaScript の fetch() で読んだときは、例外の名前と文言が次のとおりでした。エラーの番号は JavaScript からは見えず、コンソールの1行で判断します。
TypeError: Failed to fetch
同じサーバーに curl と Node.js で接続すると、それぞれ次の文言になります(この2つは Chromium とは別の実装なので、出る条件も少し違います。後の「18通りの再現」で比べます)。
curl: (92) Invalid HTTP header field was received: frame type: 1, stream: 1, name: [X-Note], value: [hello]
curl: (92) HTTP/2 stream 1 was not closed cleanly: INTERNAL_ERROR (err 2)
Node.js の err.code: ERR_HTTP2_STREAM_ERROR
Node.js の err.message: Stream closed with error code NGHTTP2_PROTOCOL_ERROR
言葉の意味も整理しておきます。どれも、ふだんの意味から少しずれた使い方をしています。
| 言葉 | ふだんの意味 | HTTP/2 での意味 |
|---|---|---|
| プロトコル | 外交などの儀礼・手順 | 通信の決まり。HTTP/2 は RFC 9113 で決まっている |
| プロトコル エラー | 手順を間違えること | 相手が決まりに合わないデータを送った、または通り道を切った |
| ストリーム | 小川・流れ | 1本の接続の中にある、要求と応答1組ぶんの通り道 |
| ヘッダー | 文書の上の欄 | 応答の前に付く「名前: 値」の組(content-type など) |
| リセット(RST_STREAM) | 初期化すること | そのストリームだけを途中で打ち切る合図 |
まず試すこと(見ている人向け・最初の5分)
この節では、サイトを見ている側が最初の5分で試す順番と、Windows・Mac・スマホ別の操作、うまくいかないときの症状表が分かります。
見ている側でできるのは「自分の環境の問題かどうか」を早く切り分けることです。上から順に試します。
キャッシュを無視して再読み込みする
Chrome の公式ヘルプのショートカットは、Windows・Linux が Shift+F5 または Ctrl+Shift+R、Mac が ⌘+Shift+R です。一時的な切断なら、これで表示されます。
シークレット ウィンドウで開く
Windows・Linux は Ctrl+Shift+N、Mac は ⌘+Shift+N。保存された Cookie やキャッシュを使わずに開けます。ここで表示できるなら、手元の閲覧データか拡張機能が関わっています。
別の回線・別の端末で開く
スマホを Wi-Fi からモバイル回線に切り替える、家族や同僚の端末で開くなど。どこでも同じなら、サイト側の問題です。サイトの運営者に、日時・URL・エラー名を伝えます。
Chrome を最新にする
Chrome の公式ヘルプの手順(「Chrome を更新して再起動する」)で更新し、再起動してから開き直します。
そのサイトの閲覧データを削除する
Windows・Linux は Ctrl+Shift+Delete、Mac は ⌘+Shift+Delete で「閲覧履歴データの削除」が開きます。期間を短くし、Cookie とキャッシュを選んで削除します。ログイン状態が消える点に注意します。
端末ごとの操作は次のとおりです。スマホの操作は Chrome の公式ヘルプに載っている名前で書いています。
| 端末 | 再読み込み | 保存データなしで開く | 閲覧データの削除 |
|---|---|---|---|
| Windows・Linux(Chrome) | Shift+F5・Ctrl+Shift+R | Ctrl+Shift+N | Ctrl+Shift+Delete |
| Mac(Chrome) | ⌘+Shift+R | ⌘+Shift+N | ⌘+Shift+Delete |
| Android(Chrome) | アプリの再読み込みの操作 | シークレット タブ(公式ヘルプの Android の手順) | 「その他」→「閲覧履歴データの削除」→「データを削除」 |
| iPhone・iPad(Chrome) | アプリの再読み込みの操作 | シークレット タブ(公式ヘルプの iPhone の手順) | 公式ヘルプの「iPhone と iPad」の手順 |
うまくいかないときは、症状から次の表で見当をつけます。
| 症状 | 考えられる原因 | 確かめ方 | 直し方 |
|---|---|---|---|
| どの端末・回線でも出る | サイト側の応答 | 別の回線のスマホで開く | 運営者に連絡して待つ |
| シークレットでは表示できる | 手元の Cookie・キャッシュ・拡張機能 | 通常のウィンドウとシークレットで比べる | そのサイトの閲覧データを削除する |
| 会社や学校の回線だけで出る | 途中のプロキシや検査の仕組み | モバイル回線で開く | 回線の管理者に URL と時刻を伝える |
| セキュリティ ソフトを入れてから出る | HTTPS の通信を中継する機能 | 別の端末では出ないか見る | ソフトの設定と提供元の案内を確かめる |
| 画面は出るが一部が欠ける | 画像・スクリプトの一部のストリームが失敗 | 開発者ツールのコンソールを見る | 再読み込み。続くなら運営者に連絡 |
| ログイン後のページだけで出る | Cookie が大きすぎる、またはサイト側の不具合 | シークレットで同じ操作をする | そのサイトの Cookie を削除して入り直す |
セキュリティ ソフトが怪しいとき
保護を外すと、エラー以外の危険まで増えます
chrome://flags を触りたくなったとき
このエラーの名前は HTTP2。HTTP/3 の設定とは別物です
127.0.0.1で18通りを再現した結果(一覧)
この節では、どんな応答で ERR_HTTP2_PROTOCOL_ERROR が出て、どんな応答では出ないのかが、手元で再現した一覧で分かります。
HTTP/2 のフレームを手で組み立てるサーバーで、ポートごとに1つずつ決まりを破りました。ヘッダーは HPACK の「索引を使わないリテラル」の形でそのまま送っています。サーバーの中心は次の数行です。
def hint(n, prefix): # HPACK の整数(先頭バイトの下位 prefix ビット+続き)
mx = (1 << prefix) - 1
if n < mx: return bytes([n])
out = [mx]; n -= mx
while n >= 128: out.append((n % 128) + 128); n //= 128
out.append(n); return bytes(out)
def lit(name, value): # 索引を使わないリテラル・新しい名前・Huffman なし
return b'\x00' + hint(len(name), 7) + name + hint(len(value), 7) + value
def frame(t, flags, sid, payload=b''): # 9バイトのフレームヘッダー+中身
return struct.pack('>I', len(payload))[1:] + bytes([t, flags]) + struct.pack('>I', sid) + payload
# 例:ヘッダー名に大文字を入れた応答(HEADERS → DATA)
block = lit(b':status', b'200') + lit(b'content-type', b'text/html') + lit(b'X-Note', b'hello')
conn.sendall(frame(1, 0x4, sid, block) + frame(0, 0x1, sid, body))
結果は次のとおりです。「Chromium」は Chromium 153 で開いたときのエラー、「curl」は curl 8.5.0 の終了コードと理由です。
| サーバーの応答 | Chromium | curl | RFC 9113 での扱い |
|---|---|---|---|
| 正しい応答 | 表示 | 0(成功) | 正しい |
| ヘッダー名に大文字(X-Note) | ERR_HTTP2_PROTOCOL_ERROR | 92 Invalid HTTP header field | 不正(8.2・8.2.1) |
| ヘッダー名に空白(x note) | ERR_HTTP2_PROTOCOL_ERROR | 92 Invalid HTTP header field | 不正(8.2.1) |
| ヘッダーの値に改行 | ERR_HTTP2_PROTOCOL_ERROR | 92 Invalid HTTP header field | 不正(8.2.1) |
| transfer-encoding: chunked | ERR_HTTP2_PROTOCOL_ERROR | 92 Invalid HTTP header field | 接続固有のヘッダー(8.2.2) |
| connection: keep-alive | 表示された | 92 Invalid HTTP header field | 接続固有のヘッダー(8.2.2) |
| :status が無い | ERR_HTTP2_PROTOCOL_ERROR | 1 Received HTTP/0.9 | 不正(8.3.2) |
| content-length 1000 で本文48バイト | 表示された | 92 PROTOCOL_ERROR (err 1) | 不正(8.1.1) |
| 本文の途中で RST_STREAM(INTERNAL_ERROR) | ERR_HTTP2_PROTOCOL_ERROR | 92 INTERNAL_ERROR (err 2) | サーバーが打ち切った |
| 本文の途中で RST_STREAM(CANCEL) | ERR_HTTP2_PROTOCOL_ERROR | 92 CANCEL (err 8) | サーバーが打ち切った |
| 要求の直後に GOAWAY(PROTOCOL_ERROR) | ERR_HTTP2_PROTOCOL_ERROR | 56(5回試して失敗) | 接続ごと終了 |
| 応答ヘッダー 約100KB | 表示された | 0(成功) | 受け手の上限しだい |
| 応答ヘッダー 約200KB | 表示された | 56 Too many CONTINUATION | 受け手の上限しだい |
| 応答ヘッダー 約300KB | ERR_HTTP2_PROTOCOL_ERROR | 56 Too many CONTINUATION | 受け手の上限しだい |
| nginx 経由・元サーバーが本文の途中で切断 | ERR_HTTP2_PROTOCOL_ERROR | 92 INTERNAL_ERROR (err 2) | 中継が打ち切った |
| nginx 経由・ヘッダーの値に制御文字 | ERR_HTTP2_PROTOCOL_ERROR | 92 Invalid HTTP header field | 不正(8.2.1) |
| nginx 経由・元サーバーが大文字・chunked で応答 | 表示された | 0(成功) | nginx が直して送った |
| nginx へ約20KBの Cookie を送る | ERR_CONNECTION_CLOSED | 56 Failure when receiving data | GOAWAY(ENHANCE_YOUR_CALM) |
1ヘッダーの形の違反は即エラー
大文字・空白・改行・transfer-encoding・:status 無しは、Chromium も curl もそろって拒否しました。
2ブラウザーと curl で結果が違う
connection ヘッダーと content-length の食い違いは、Chromium では表示され、curl だけが失敗しました。curl で出てもブラウザーで出ないことがあります。
3サーバーの打ち切りも同じ番号
RST_STREAM の理由が INTERNAL_ERROR でも CANCEL でも、Chromium の表示は ERR_HTTP2_PROTOCOL_ERROR でした。
4大きな Cookie は別の番号
nginx が大きな Cookie を断ったときは、ERR_HTTP2_PROTOCOL_ERROR ではなく ERR_CONNECTION_CLOSED でした。
Node.js 22.23.4 の node:http2 クライアントでも6通りを試すと、大文字・transfer-encoding・content-length の食い違いは NGHTTP2_PROTOCOL_ERROR、途中の RST_STREAM は NGHTTP2_INTERNAL_ERROR で失敗し、値に改行を入れたヘッダーは受け取って status 200 で読み終えました。クライアントごとに点検の厳しさが違います。
原因1:HTTP/2で禁止されたヘッダー(大文字・改行・Transfer-Encoding)
この節では、HTTP/2 で送ってはいけないヘッダーの種類と、Chromium がそれをどう判断したかが NetLog の原文で分かります。
HTTP/1.1 では許されていた書き方の一部が、HTTP/2 では禁止されています。RFC 9113 の決まりを短くまとめると次のとおりです。
- 名前は小文字だけ(8.2)。名前に 0x00〜0x20(空白を含む)、0x41〜0x5a(英大文字)、0x7f〜0xff の文字を含めない(8.2.1)。
- 値に NUL・LF(改行)・CR を含めない(8.2.1)。
- 接続固有のヘッダーを送らない(8.2.2)。Connection・Proxy-Connection・Keep-Alive・Transfer-Encoding・Upgrade が当たる。要求の TE だけは「trailers」の値に限って許される。
- 応答には :status が必ず要る(8.3.2)。
- 決まりに合わない応答は「不正な形(malformed)」として扱い、ストリームのエラーにする(8.1.1)。
Chromium が拒否した理由は、NetLog に英語の1行で残ります。手元で記録した NetLog(JSON)から、該当するイベントを抜き出しました。
HTTP2_SESSION_RECV_INVALID_HEADER {"error": "Upper case characters in header name.", "header_name": "X-Note", "header_value": "hello"}
HTTP2_SESSION_RECV_INVALID_HEADER {"error": "Invalid character in header name.", "header_name": "x note", "header_value": "hello"}
HTTP2_SESSION_RECV_INVALID_HEADER {"error": "Invalid character 0x0A in header value.", "header_name": "x-note", "header_value": "line1\nline2"}
HTTP2_SESSION_SEND_RST_STREAM {"description": "Received transfer-encoding header", "error_code": "1 (PROTOCOL_ERROR)", "stream_id": 1}
HTTP2_STREAM_ERROR {"description": "Response headers do not include :status.", "net_error": "ERR_HTTP2_PROTOCOL_ERROR", "stream_id": 1}
どの場合も、Chromium は自分から RST_STREAM(PROTOCOL_ERROR)を送ってストリームを閉じ、画面には ERR_HTTP2_PROTOCOL_ERROR を出しました。ブラウザーが自分から切るため、サーバー側では原因に気づきにくい種類です。
直し方は、そのヘッダーを出しているコードを探して止めることです。よくある出どころは次の4つです。
アプリが直接書いている
HTTP/1.1 の時代の名残で Connection: keep-alive や Transfer-Encoding を手で付けている
ユーザーの入力やファイル名を、改行を除かずにヘッダーへ入れている
大文字の名前をそのまま出す自作のサーバー
中継が素通しにしている
元サーバーの不正な値を、中継がそのまま HTTP/2 で送っている(原因4)
中継の設定で add_header などに制御文字が入っている
ライブラリの版が以前のもので、点検が入っていない
手元の nginx は、元サーバーが HTTP/1.1 で返した X-Upper: Hello・Connection: keep-alive・Transfer-Encoding: chunked を、小文字の x-upper に直し、Connection と Transfer-Encoding を外して HTTP/2 で送りました(Chromium も curl も表示)。ただし中継が直さずに素通しにする種類もあります(原因4)。
原因2:応答が途中で切れる(RST_STREAM・元サーバーの切断)
この節では、応答が途中で切れたときに「200 なのに失敗」と見える理由と、nginx のログでの見つけ方が分かります。
サーバーが応答ヘッダー(200)を送ったあと、本文の途中でストリームを打ち切ると、ブラウザーには「200 を受け取ったのに読み込みに失敗した」と残ります。Playwright で記録した Chromium の出来事は次の順でした。
response 200 https://localhost:18737/
requestfailed net::ERR_HTTP2_PROTOCOL_ERROR https://localhost:18737/
console[error] Failed to load resource: net::ERR_HTTP2_PROTOCOL_ERROR
NetLog には、サーバーから RST_STREAM を受け取ったことと、それを ERR_HTTP2_PROTOCOL_ERROR として扱ったことが出ています。
HTTP2_SESSION_RECV_HEADERS {"fin": false, "headers": [":status: 200", "content-type: text/html; charset=utf-8", "content-length: 1000"], "stream_id": 1}
HTTP2_SESSION_RECV_RST_STREAM {"error_code": "2 (INTERNAL_ERROR)", "stream_id": 1}
HTTP2_STREAM_ERROR {"description": "Server reset stream.", "net_error": "ERR_HTTP2_PROTOCOL_ERROR", "stream_id": 1}
実際のサイトでよく起きるのは、nginx などの中継の後ろで、アプリ(元サーバー)が応答の途中で落ちたり接続を閉じたりする場合です。元サーバーに「Content-Length: 100000 と言って20バイトで閉じる」応答を返させ、nginx を HTTP/2 で通しました。
$ curl --http2 --cacert cert.pem -sS -D - -o /dev/null https://localhost:18750/short
HTTP/2 200
content-type: text/plain
content-length: 100000
curl: (92) HTTP/2 stream 1 was not closed cleanly: INTERNAL_ERROR (err 2)
nginx の error.log には、元サーバーが途中で閉じたことが残りました。運営側はまずこの1行を探します。
[error] 4789#4789: *3 upstream prematurely closed connection while reading upstream, client: 127.0.0.1, server: , request: "GET /short HTTP/2.0", upstream: "http://127.0.0.1:18760/short", host: "localhost:18750"
同じ元サーバーを、同じ nginx の HTTP/1.1 の口から開くと、エラーの名前が変わりました。
| 同じ「途中で切れる応答」 | Chromium の表示 | curl の表示 |
|---|---|---|
| HTTP/2 で受け取る | ERR_HTTP2_PROTOCOL_ERROR | (92) HTTP/2 stream 1 was not closed cleanly: INTERNAL_ERROR (err 2) |
| HTTP/1.1 で受け取る | ERR_CONTENT_LENGTH_MISMATCH | (18) transfer closed with 99980 bytes remaining to read |
HTTP/1.1 なら別の名前で出る失敗が、HTTP/2 の上ではこの名前になるわけです。途中で切れる理由(アプリの例外や強制終了、時間切れ、中継の一時ファイルを書けないなど)はサーバーの中にあるので、元サーバーと中継のログを同じ時刻で突き合わせます。
原因3:大きすぎるヘッダー(応答は256KB・要求のCookieは8KB)
この節では、ヘッダーが大きすぎるときにどこで断られるのかが、実際に計算した境目の数字で分かります。
応答のヘッダー:接続の始めに Chromium が送ってきた SETTINGS フレームをサーバー側で記録すると、[(1, 65536), (2, 0), (4, 6291456), (6, 262144)] でした。6 番が SETTINGS_MAX_HEADER_LIST_SIZE で、「この大きさまでのヘッダーなら受け取る」という知らせです。RFC 9113 では、大きさを「名前と値のバイト数+1行あたり32バイト」で数えます。4,000 バイトの値のヘッダーを25本・50本・75本付けた応答を、この数え方で計算すると次のとおりです。
| 応答ヘッダー | RFC の数え方での大きさ | 上限 262,144 との比較 | Chromium の結果 |
|---|---|---|---|
| 4,000バイト×25本 | 101,148 | 下回る | 表示された |
| 4,000バイト×50本 | 202,148 | 下回る | 表示された |
| 4,000バイト×75本 | 303,148 | 上回る | ERR_HTTP2_PROTOCOL_ERROR |
計算では、65本目(x-pad-64)を足した時点で合計が 262,748 になり、上限を超えます。NetLog の記録も、ちょうどそのヘッダーで止まっていました。
HTTP2_SESSION_RECV_INVALID_HEADER {"error": "Header list too large.", "header_name": "x-pad-64", ...}
HTTP2_SESSION_SEND_RST_STREAM {"description": "Could not parse Spdy Control Frame Header.", "error_code": "1 (PROTOCOL_ERROR)", "stream_id": 1}
curl 8.5.0(nghttp2 1.59.0)は、約100KB は受け取りましたが、約200KB で Too many CONTINUATION frames following a HEADER frame となりました。HEADERS フレームに入りきらないヘッダーは CONTINUATION フレームに分けて送るため、その数の上限に当たったものです。
要求のヘッダー(Cookie):nginx の公式ドキュメントでは、large_client_header_buffers(既定 4 8k)が HTTP/2 にも同じように効き、1つのヘッダーの上限は「HPACK で圧縮したあとの大きさ」で比べると書かれています。そこで hpack 4.2.0 で、a=xxxx… という値を Huffman 符号にしたときの大きさを計算しました(x は7ビット、a は5ビット、= は6ビットの符号)。
| x の数 | そのままの大きさ | Huffman 後 | nginx 1.24(HTTP/2) |
|---|---|---|---|
| 9,000 | 9,002 | 7,877 | 200 |
| 9,360 | 9,362 | 8,192 | 200 |
| 9,361 | 9,363 | 8,193 | 接続を切られた |
| 20,000 | 20,002 | 17,502 | 接続を切られた |
計算の 8,192 と 8,193 の境目が、curl で試した結果とぴったり一致しました。断られたときの nginx の error.log と curl の表示は次のとおりです。
[info] 8462#8462: *13 client sent too large header field while processing HTTP/2 connection, client: 127.0.0.1, server: 127.0.0.1:18750
$ curl --http2 -v ... -H "Cookie: a=xxxx…(20,000文字)" https://localhost:18750/
* received GOAWAY, error=11, last_stream=1
* Closing connection
error=11 は RFC 9113 の ENHANCE_YOUR_CALM(相手が負荷をかけすぎていると判断した)です。このとき Chromium の表示は ERR_CONNECTION_CLOSED(「localhost により途中で接続が切断されました。」)で、ERR_HTTP2_PROTOCOL_ERROR ではありませんでした。同じ Cookie を HTTP/1.1 の口へ送ると、nginx は 400 Request Header Or Cookie Too Large のページを返しました。大きな Cookie が原因でも、この組み合わせでは別のエラー名になる点を切り分けに使えます。
原因4:プロキシ・CDNと元サーバーの食い違い
この節では、中継(リバース プロキシ・CDN)を通したときだけ出る理由と、HTTP/2 を切ると直ったように見える理由が分かります。
多くのサイトは、ブラウザーと HTTP/2 で話すのは中継で、中継と元サーバーの間は HTTP/1.1 です。元サーバーの応答は HTTP/1.1 としては通っても、中継がそれを HTTP/2 に詰め替えた時点で決まり違反になることがあります。元サーバーに値の中に制御文字(0x01)を含むヘッダーを返させ、nginx 1.24 を通しました。
$ curl --http2 --cacert cert.pem -sS -D - -o /dev/null https://localhost:18750/badval
HTTP/2 200
content-type: text/plain
content-length: 2
curl: (92) Invalid HTTP header field was received: frame type: 1, stream: 1, name: [x-note], value: [ab]
curl の表示では値が [ab] に見えますが、a と b の間に目に見えない 0x01 があります。手元の nginx はこのヘッダーを素通しにし、Chromium は ERR_HTTP2_PROTOCOL_ERROR を出しました。ところが同じ nginx の HTTP/1.1 の口から開くと、Chromium はページ(「ok」)を表示しました。
| 元サーバーの応答 | nginx の HTTP/2 の口 | nginx の HTTP/1.1 の口 |
|---|---|---|
| 値に制御文字のあるヘッダー | ERR_HTTP2_PROTOCOL_ERROR | 表示された |
| 本文の途中で切断 | ERR_HTTP2_PROTOCOL_ERROR | ERR_CONTENT_LENGTH_MISMATCH |
| 大文字・Connection・chunked | 表示された(nginx が直した) | 表示された |
「HTTP/2 を切ったら直った」という報告が出るのはこのためです。表示は戻っても、元サーバーが不正な値を出している事実や、応答が途中で切れている事実は残ります。HTTP/2 を切るのは一時しのぎにとどめ、元サーバーのヘッダーとログを直します。
CDN を通したときだけ出る場合は、CDN を通さずに元サーバーへ直接 curl で接続し、同じヘッダーが出ていないかを確かめます。curl の --resolve オプションを使うと、URL のホスト名はそのままで、接続先の IP アドレスだけを元サーバーに向けられます。CDN の設定画面の項目名や挙動は提供元ごとに違うので、提供元の公式ドキュメントで確かめます。
curl --http2 -v での確かめ方
この節では、curl でエラーを再現し、どこで失敗したかを読み取る手順と、終了コードの意味が分かります。
curl なら、HTTP/2 で通っているか、どのヘッダーで失敗したかが1画面で分かります。-o /dev/null で本文を捨て、-D - で応答ヘッダーだけを表示します。
# HTTP/2 で取りにいき、ヘッダーと終了コードを見る
curl --http2 -sS -D - -o /dev/null -w 'code=%{http_code} ver=%{http_version}\n' https://example.com/
echo "exit=$?"
# 同じ URL を HTTP/1.1 で取り、結果が変わるか比べる
curl --http1.1 -sS -D - -o /dev/null https://example.com/
# 詳しい流れ(ALPN・送ったヘッダー・理由の行)を見る
curl --http2 -v -o /dev/null https://example.com/ 2>&1 | grep -E 'ALPN|HTTP/2|Invalid|not closed|GOAWAY|^< '
手元の「値に改行」のサーバーで -v を付けると、次の行が要点です。
* ALPN: curl offers h2,http/1.1
* ALPN: server accepted h2
* using HTTP/2
> GET / HTTP/2
* Invalid HTTP header field was received: frame type: 1, stream: 1, name: [x-note], value: [line1
line2]
< HTTP/2 200
< content-type: text/html; charset=utf-8
< content-length: 48
* HTTP/2 stream 1 was not closed cleanly: PROTOCOL_ERROR (err 1)
「ALPN: server accepted h2」で HTTP/2 が選ばれたこと、「Invalid HTTP header field」で問題のヘッダーの名前と値が分かります。curl の終了コードは次の意味です(説明は curl の公式のエラー一覧)。
| 終了コード | curl の公式の説明 | 手元で出た場面 |
|---|---|---|
| 92 | Stream error in the HTTP/2 framing layer. | 禁止されたヘッダー・RST_STREAM・content-length の食い違い |
| 16 | A problem was detected in the HTTP2 framing layer. | 手元では出なかった |
| 56 | Failure with receiving network data. | GOAWAY・CONTINUATION が多すぎる・大きな Cookie |
| 55 | Failed sending network data. | 約70KBの Cookie を送る途中で切られた |
| 18 | A file transfer was shorter or larger than expected. | HTTP/1.1 で本文が途中で切れた |
curl で 92 が出てブラウザーでは表示できる場合も、ほかのクライアント(アプリなど)では失敗しうるので、直しておくのが安全です。
ChromeのNetLog(chrome://net-export)で理由を見る
この節では、ブラウザーがストリームを切った理由を NetLog で確かめる手順と、イベントの読み方が分かります。
開発者ツールのコンソールには「ERR_HTTP2_PROTOCOL_ERROR」しか出ません。理由の英文は NetLog に残ります。Chromium プロジェクトの案内にある取り方は次のとおりです。
- 1新しいタブで chrome://net-export/ を開くこのタブは記録が終わるまで閉じない
- 2「Start Logging To Disk」を押して保存先を選ぶ起動の直後から記録したいときは起動時の --log-net-log オプション
- 3別のタブでエラーを起こすエラーが出るページを開き直す
- 4「Stop Logging」を押すJSON のファイルができる
- 5HTTP2_ で始まるイベントを探すINVALID_HEADER・RST_STREAM・GOAWAY・STREAM_ERROR
NetLog は JSON なので、イベントの番号を名前に直せば Python で読めます。手元では次のように抜き出しました。
import json
d = json.load(open('netlog.json'))
names = {v: k for k, v in d['constants']['logEventTypes'].items()}
for e in d['events']:
n = names.get(e['type'], '')
if n.startswith('HTTP2_') and any(k in n for k in ('INVALID', 'RST', 'GOAWAY', 'ERROR')):
print(n, e.get('params', {}))
| NetLog のイベント | 意味 | 疑う場所 |
|---|---|---|
| HTTP2_SESSION_RECV_INVALID_HEADER | 受け取ったヘッダーを不正と判断した(理由が error に入る) | アプリ・中継のヘッダー |
| HTTP2_SESSION_SEND_RST_STREAM | ブラウザーがストリームを打ち切った | description の理由を読む |
| HTTP2_SESSION_RECV_RST_STREAM | サーバー側がストリームを打ち切った | 元サーバーの例外・時間切れ |
| HTTP2_SESSION_RECV_GOAWAY | サーバー側が接続ごと終えた(error_code に理由) | 中継の上限・再起動 |
| HTTP2_STREAM_ERROR | 最終的にどの net_error にしたか | ERR_HTTP2_PROTOCOL_ERROR かどうか |
NetLog には開いた URL や Cookie の情報が入ることがあります。Chromium の案内でも、詳しい記録には個人の情報が入りうると注意しています。社外に渡すときは、渡す相手と中身を先に確かめます。
運営側の直し方チェックリスト(nginx・アプリ・CDN)
この節では、サイトを運営・開発している側が上から順に確かめる項目と、nginx の設定の書き方が分かります。
- 1curl --http2 -v で再現するどのヘッダーか、RST_STREAM か GOAWAY かを最初に分ける
- 2中継の error.log を同じ時刻で見るnginx なら upstream prematurely closed connection・client sent too large header field
- 3アプリが接続固有のヘッダーを出していないかConnection・Keep-Alive・Transfer-Encoding・Upgrade を手で付けない
- 4ヘッダーの値に改行や制御文字が入らないかファイル名・リダイレクト先・ユーザーの入力をヘッダーに入れる箇所
- 5Content-Length を手で計算していないか文字数とバイト数の取り違え。フレームワークの自動計算に任せる
- 6応答が途中で止まる理由を探すアプリの例外・時間切れ・ディスクの空き・一時フォルダーの権限
- 7Set-Cookie と Cookie の大きさを数える応答は 256KB、nginx の要求は1つ 8KB(圧縮後)が手元の境目
- 8CDN を通さずに元サーバーを直接確かめるcurl --resolve で接続先だけを元サーバーに向ける
nginx で HTTP/2 を有効にする書き方は、版で変わりました。公式ドキュメントでは http2 ディレクティブが 1.25.1 で加わっています。手元の 1.24.0 は listen の http2 パラメーターで書きました。
# nginx 1.25.1 以降(公式ドキュメントの例と同じ形)
server {
listen 443 ssl;
http2 on;
ssl_certificate server.crt;
ssl_certificate_key server.key;
# 1つの要求ヘッダーの上限(HTTP/2 では HPACK 圧縮後の大きさで比べる)
large_client_header_buffers 4 8k;
location / {
proxy_pass http://127.0.0.1:8080;
}
}
# nginx 1.24 まで(手元で動かした書き方)
# listen 127.0.0.1:18750 ssl http2;
http2_max_field_size と http2_max_header_size は 1.19.7 から使われなくなり、large_client_header_buffers を使うと公式ドキュメントに書かれています。上限を上げる前に、なぜそこまで大きな Cookie ができているのかを確かめるほうが、根本の対策になります。
アプリ側では、ヘッダーに入れる値を出す直前で点検しておくと、この種類のエラーを防げます。次は手元で動かした確かめ方の例です。
import re
BAD_NAME = re.compile(r'[\x00-\x20A-Z\x7f-\xff]') # RFC 9113 8.2.1 の名前の禁止範囲
BAD_VALUE = re.compile(r'[\x00\r\n]') # 値の NUL・CR・LF
CONN_SPECIFIC = {'connection', 'proxy-connection', 'keep-alive', 'transfer-encoding', 'upgrade'}
def check(name, value):
if BAD_NAME.search(name): return 'NG 名前'
if BAD_VALUE.search(value): return 'NG 値'
if name in CONN_SPECIFIC: return 'NG 接続固有'
return 'OK'
for h in [('x-note', 'hello'), ('X-Note', 'hello'), ('x note', 'hi'),
('x-note', 'line1\nline2'), ('transfer-encoding', 'chunked')]:
print(h[0], '->', check(*h))
x-note -> OK
X-Note -> NG 名前
x note -> NG 名前
x-note -> NG 値
transfer-encoding -> NG 接続固有
リバース プロキシの基本の設定は関連記事「Nginxリバースプロキシ設定|proxy_passの書き方と502/504対処」で扱っています。
似たエラーとの違い(QUIC・SSL・CONNECTION_CLOSEDなど)
この節では、名前の似た Chromium のエラーとの違いと、それぞれの番号が分かります。説明は Chromium のソースの記載です。
| エラー | 番号 | ソースの説明(要約) | 見分け方 |
|---|---|---|---|
| ERR_HTTP2_PROTOCOL_ERROR | -337 | HTTP/2 のプロトコル エラー | HTTP/2 の通信が始まったあとの違反・打ち切り |
| ERR_QUIC_PROTOCOL_ERROR | -356 | QUIC のプロトコル エラー | HTTP/3(QUIC)の上での失敗 |
| ERR_SSL_PROTOCOL_ERROR | -107 | SSL のプロトコル エラー | HTTP/2 が始まる前の TLS の段階で失敗 |
| ERR_CONNECTION_CLOSED | -100 | 接続が閉じられた(TCP の FIN) | 手元では大きな Cookie への GOAWAY でこれになった |
| ERR_CONNECTION_RESET | -101 | 接続がリセットされた(TCP の RST) | 接続そのものが RST で切られた |
| ERR_CONTENT_LENGTH_MISMATCH | -354 | 本文が Content-Length より短いまま接続が閉じた | HTTP/1.1 で本文が途中で切れたとき |
| ERR_EMPTY_RESPONSE | -324 | サーバーが何も送らずに接続を閉じた | 応答が1バイトも無い |
| ERR_HTTP2_SERVER_REFUSED_STREAM | -351 | サーバーが要求を処理せずに断った | REFUSED_STREAM など。別の接続で送り直してよい |
TCP の段階で切られる場合の切り分けは、別の記事「ERR_CONNECTION_RESETの原因と直し方|RSTの実物で切り分け」で、RST の実物とともに扱っています。HTTP のステータスコード全体は関連記事「HTTPステータスコード 一覧|全コードの原因と対処・curl実例つき」にまとめています。
よくあるエラー/つまずき
この節では、調べている途中でつまずきやすい点が、表示の原文つきで分かります。
| つまずき | 表示の原文 | 原因 | 直し方 |
|---|---|---|---|
| 開発者ツールでは 200 なのに失敗 | Failed to load resource: net::ERR_HTTP2_PROTOCOL_ERROR | ヘッダーのあと、本文の途中で切られた | 元サーバーと中継のログを同じ時刻で見る |
| curl では失敗、ブラウザーでは表示 | curl: (92) Invalid HTTP header field was received: … name: [connection] | curl のほうが厳しい項目がある | アプリの connection ヘッダーを外す |
| curl で値が見えない | name: [x-note], value: [ab] | 目に見えない制御文字が入っている | 値を16進で出して確かめる |
| curl が何度も送り直す | curl: (56) Connection died, tried 5 times before giving up | 要求を処理する前に GOAWAY を受けた | 中継の再起動・上限の設定を見る |
| 大きな応答ヘッダーで curl だけ失敗 | Too many CONTINUATION frames following a HEADER frame | CONTINUATION フレームの数の上限 | Set-Cookie などを減らす |
判断表:どこを確かめ、どこを直すか
この節では、手元で分かった事実から、確かめる場所と直す人を選べます。
| 分かったこと | 疑う場所 | 次にすること | 直す人 |
|---|---|---|---|
| どの端末・回線でも出る | サイト側 | 運営者に日時・URL・エラー名を伝える | 運営者 |
| シークレットでは出ない | 手元の閲覧データ・拡張機能 | そのサイトの閲覧データを削除 | 見ている人 |
| 特定の回線だけで出る | 途中のプロキシ・検査 | 回線の管理者に伝える | 回線の管理者 |
| curl で Invalid HTTP header field | アプリ・中継のヘッダー | 名前・値・接続固有のヘッダーを直す | 開発者 |
| curl で not closed cleanly | 元サーバーの途中の停止 | error.log・アプリのログを見る | 開発者・運用者 |
| CDN を外すと出ない | CDN の設定・CDN と元サーバーの間 | 提供元のドキュメントで設定を確かめる | 運用者 |
| HTTP/2 を切ると表示される | 不正なヘッダー・途中の切断が隠れている | HTTP/2 は戻し、原因を直す | 開発者 |
よくある質問
この節では、ERR_HTTP2_PROTOCOL_ERROR についてよく聞かれることの答えが分かります。
Q. ERR_HTTP2_PROTOCOL_ERROR は自分のパソコンの故障ですか? A. 故障とは限りません。手元で再現できた原因は、どれもサーバーや中継の応答でした。別の端末・別の回線でも出るなら、サイト側の問題です。
Q. 再読み込みで直るのはなぜですか? A. 応答の途中で切れる原因が一時的なもの(元サーバーの再起動・一瞬の時間切れなど)なら、次の要求では最後まで届くからです。何度も出るなら、サーバー側に続く原因があります。
Q. Chrome で HTTP/2 を切ることはできますか? A. 起動時のオプションで変える方法を紹介する記事もありますが、見ている側で HTTP/2 を切っても、サイト側の原因は直りません。この記事ではその手順は勧めず、シークレット ウィンドウと別の端末での切り分けを勧めます。
Q. 開発者ツールに 200 と出ているのに失敗するのはなぜですか? A. ステータスとヘッダーは届いたあと、本文の途中でストリームが打ち切られたからです。手元でも、応答 200 を受け取った直後に同じ要求が net::ERR_HTTP2_PROTOCOL_ERROR で失敗しました。
Q. nginx で出ます。最初に見るのはどこですか? A. error.log です。手元では「upstream prematurely closed connection while reading upstream」(元サーバーが途中で閉じた)と「client sent too large header field」(要求のヘッダーが大きすぎる)が出ました。
Q. Cookie を消すと直るのはなぜですか? A. Cookie が大きすぎて中継に断られていた場合や、Cookie によってサイトの動きが変わり、不具合のある経路を通っていた場合が考えられます。手元の nginx では、大きな Cookie は ERR_CONNECTION_CLOSED になりました。
Q. ERR_HTTP2_PROTOCOL_ERROR と ERR_QUIC_PROTOCOL_ERROR の違いは? A. 前者は HTTP/2、後者は HTTP/3(QUIC)の上での失敗です。番号も -337 と -356 で別です。
Q. セキュリティ ソフトが原因になることはありますか? A. HTTPS の通信を中継して検査する機能があるソフトでは、その中継が応答を作り直す途中で決まりに合わない形になる可能性があります。別の端末では出ないかを比べ、ソフトの設定と提供元の案内を確かめます。保護の機能を切ったままにはしません。
Q. 開発者ツールの使い方が分かりません。 A. コンソールとネットワークの見方は関連記事「Chrome DevToolsの使い方|デバッグ手順と便利機能一覧」で扱っています。curl の基本は関連記事「curlとは?curlコマンドの使い方とオプション一覧|Windows・エラー対処」、Cookie の仕組みは関連記事「Cookieとセッションの違いと仕組み|セッションIDの流れを図解」が詳しいです。
まとめ
- ERR_HTTP2_PROTOCOL_ERROR(-337)は、HTTP/2 の決まりに合わない応答を受け取ったか、応答の途中でストリームを切られたときの表示。見ている側は、再読み込み・シークレット ウィンドウ・別の回線の順に切り分ける。
- 手元の Chromium 153 では、ヘッダー名の大文字・空白、値の改行、transfer-encoding、:status 無し、本文の途中の RST_STREAM、GOAWAY、256KB を超える応答ヘッダーでこのエラーになった。
- 同じ応答でもクライアントで結果が違う。connection ヘッダーと content-length の食い違いは Chromium では表示され、curl だけが失敗した。
- 途中で切れる応答は、HTTP/1.1 なら ERR_CONTENT_LENGTH_MISMATCH になる失敗。nginx では「upstream prematurely closed connection」を探す。HTTP/2 を切ると表示が戻ることがあるが、原因は残る。
- 大きな Cookie は nginx 1.24 では HPACK 圧縮後 8,193 バイトから断られ、Chromium の表示は ERR_CONNECTION_CLOSED だった。理由の英文は NetLog(chrome://net-export)で確かめられる。
参考・出典
確認日はいずれも 2026年11月13日です。
- Chromium のソース「net/base/net_error_list.h」:https://chromium.googlesource.com/chromium/src/+/main/net/base/net_error_list.h
- IETF「RFC 9113 HTTP/2」6.5.2・7・8.1.1・8.2・8.2.1・8.2.2・8.3.2:https://www.rfc-editor.org/rfc/rfc9113
- curl「libcurl error codes」:https://curl.se/libcurl/c/libcurl-errors.html
- nginx「Module ngx_http_v2_module」:https://nginx.org/en/docs/http/ngx_http_v2_module.html
- nginx「Module ngx_http_core_module」large_client_header_buffers:https://nginx.org/en/docs/http/ngx_http_core_module.html#large_client_header_buffers
- Google Chrome ヘルプ「Chrome の接続エラーと読み込みエラーを解決する」:https://support.google.com/chrome/answer/6098869?hl=ja
- Google Chrome ヘルプ「Chrome のキーボード ショートカット」:https://support.google.com/chrome/answer/157179?hl=ja
- Google Chrome ヘルプ「Chrome で閲覧履歴データを削除する」:https://support.google.com/chrome/answer/2392709?hl=ja
- The Chromium Projects「Providing Network Details for bug reports」:https://www.chromium.org/for-testers/providing-network-details/
本記事の内容は、ご自由にお使いください。
ご利用の際は、出典として本ページへのリンクを記載いただけますようお願いします。
(記載例)出典:株式会社RJC「ERR_HTTP2_PROTOCOL_ERRORの原因と直し方|原因別に再現」
株式会社RJC ― SI事業・SES事業・AI駆動開発。RJCは一緒に成長を楽しめる会社です。
WE ARE HIRING
RJCで一緒に開発しながら、
成長を楽しみませんか?
RJCは、Web・モバイル・AIを活用した開発プロジェクトで、テックリードやPM・PMOも活躍するシステム開発会社です。会社を知る、待遇を確かめる、話を聞いてみる。気になるところ見てみてください!
- 127日年間休日
- 12時間平均残業時間
- 毎日ガチャ遊びココロも大切にする福利厚生。アマギフなどの賞品ラインナップ!
ほかにも、チケットレストラン、書籍読み放題、2年ごとの慰労報奨(休暇 or 金一封)、11期連続の黒字決算。