---
title: "Accept-Encodingとは？gzip・br・zstdの指定とContent-Encodingとの違い"
url: "https://www.issoh.co.jp/tech/details/6855/"
published: 2025-05-21
updated: 2026-10-25
categories: ["プロトコル"]
publisher: "株式会社一創"
---

# Accept-Encodingとは？gzip・br・zstdの指定とContent-Encodingとの違い

Accept-Encodingは、クライアントが受け取れる圧縮方式（コンテンツコーディング）をサーバーへ伝えるHTTPリクエストヘッダです。サーバーはこの値を見て圧縮方式を選び、実際に使った方式をレスポンスの`Content-Encoding`で返します。この記事では、RFC 9110での解釈、ブラウザや各HTTPクライアントが実際に送る値、`Content-Encoding: br`を解凍できないときの症状、圧縮の確認手順、サーバー設定の既定値を扱います。2026年10月25日時点の一次情報と、手元で実行した結果をもとにしています。

## まとめ：Accept-Encodingの要点

- Accept-Encodingは「受け取れる圧縮方式」の申告で、サーバーが選んだ結果は`Content-Encoding`に出る。
- 主な値は`gzip`・`br`（Brotli）・`zstd`（Zstandard）・`deflate`。現行のChrome・Firefoxは`gzip, deflate, br, zstd`を送り、Safariがzstdを送るのは26.3以降。
- ヘッダが無いリクエストは「どのコーディングでも可」と解釈される（RFC 9110）。非圧縮だけを求めるなら`identity`を明示する。
- `gzip;q=0`で拒否しても、今回の計測ではCloudflareとMDNの配信基盤がgzipで返してきた。受け取った側は`Content-Encoding`を必ず確かめる。
- brやzstdで返ってきたとき、Brotliとzstdなしでビルドされたcurl（今回は8.7.1）は`--compressed`指定時に終了コード61で止まり、Brotliライブラリの無いPythonのrequestsは圧縮されたバイト列をそのまま返す。Java標準の`HttpClient`はgzipも解凍しない。
- Accept-Encodingで表現を切り替えてキャッシュさせるなら`Vary: Accept-Encoding`を付ける。nginxは既定で付けない。

## Accept-Encodingの役割とContent-Encoding・Acceptとの違い

### リクエストとレスポンスでの対応関係

[RFC 9110の12.5.3節](https://www.rfc-editor.org/rfc/rfc9110.html#section-12.5.3)によると、Accept-Encodingはユーザーエージェントがリクエストで送ると「レスポンスで受け入れられるコンテンツコーディング」を示します。サーバーは候補の中から1つを選んで本文を圧縮し、`Content-Encoding: br`のように使った方式を付けて返します。

```
GET /index.html HTTP/1.1
Host: example.com
Accept-Encoding: gzip, deflate, br, zstd

HTTP/1.1 200 OK
Content-Type: text/html; charset=utf-8
Content-Encoding: br
Vary: Accept-Encoding
```

Accept-Encodingで非圧縮が拒否されていなければ、サーバーは圧縮せずに返せます。そのときレスポンスには`Content-Encoding`が付きません。

レスポンス側に`Accept-Encoding`が付くこともあります。RFC 9110は、リクエスト本文のコーディングに対応できないサーバーが415（Unsupported Media Type）を返すとき、受け付けられる方式をAccept-Encodingで知らせる使い方を「最も一般的な用途」として挙げています。

### Content-Encoding: brの意味とContent-Type: application/gzipとの区別

`Content-Encoding: br`は「本文をBrotliで圧縮して送った。解凍してから`Content-Type`の形式として読むこと」という通知です。HTMLなら`Content-Type: text/html`のまま、本文だけがBrotliの圧縮データになっています。ブラウザは自動で解凍するので、開発者ツールでは元のHTMLとして表示されます。

紛らわしいのが`Content-Type: application/gzip`です。こちらは本文のデータ形式がgzipファイルであることを示すメディアタイプで（RFC 6713）、HTTPの層では解凍されません。ブラウザは通常、.gzファイルとしてダウンロードし、中身をどう扱うかは受け取ったアプリケーション次第です。2026年10月25日に確認すると、rsyncの配布元（download.samba.org）はtar.gzを`application/gzip`、nginx.orgとpython.orgは`application/octet-stream`で返し、どれも`Content-Encoding`は付けていませんでした。逆に.tar.gzに`Content-Encoding: gzip`を付けるサーバーでは、curlの`--compressed`やブラウザが解凍してしまい、保存したファイルのハッシュが配布元の値と合わなくなります。

### Content-EncodingとTransfer-Encodingの適用範囲の違い

Content-Encodingは表現（ファイルそのもの）にかかる符号化で、キャッシュされるのも圧縮済みの状態です。一方のTransfer-Encoding（`chunked`など）はHTTP/1.1の転送区間だけの符号化です。HTTP/2（RFC 9113）ではTransfer-Encodingを含むメッセージは不正として扱われます。HTTP/3の土台であるQUICについては[QUIC（通信プロトコル）とは？HTTP/3を支える仕組みとTCPとの違い](/tech/details/16234/)で解説しています。

### Accept系ヘッダの役割分担

Accept、Accept-Encoding、Accept-Languageはどれもクライアントの希望を伝えるヘッダ（コンテンツネゴシエーション）ですが、指定する対象が違います。

| リクエストヘッダ            | 伝える内容   | 値の例                         | サーバーの応答ヘッダ           |
| ------------------- | ------- | --------------------------- | -------------------- |
| Accept              | メディアタイプ | text/html, application/json | Content-Type         |
| Accept-Encoding     | 圧縮方式    | gzip, br, zstd              | Content-Encoding     |
| Accept-Language     | 言語      | ja, en;q=0.8                | Content-Language     |
| Accept-Charset（非推奨） | 文字コード   | utf-8                       | Content-Typeのcharset |

## 指定できる値：gzip・br・zstd・deflateとIANA登録一覧

使える値は[IANAの「HTTP Content Coding Registry」](https://www.iana.org/assignments/http-parameters/http-parameters.xhtml)で管理されています。登録から実務で目にするものを抜き出しました。

| 値         | 形式                       | 規定                | ブラウザの対応                            |
| --------- | ------------------------ | ----------------- | ---------------------------------- |
| gzip      | GZIP（RFC 1952）           | RFC 9110          | 全ブラウザ                              |
| deflate   | zlib形式のdeflate           | RFC 9110          | 全ブラウザ                              |
| br        | Brotli                   | RFC 7932          | Chrome 50・Firefox 44・Safari 11     |
| zstd      | Zstandard（窓8MB以下）        | RFC 9659・RFC 8878 | Chrome 123・Firefox 126・Safari 26.3 |
| dcb / dcz | 共有辞書つきBrotli / Zstandard | RFC 9842          | Chrome 130（Safariは未対応）             |
| identity  | 符号化なし（予約語）               | RFC 9110          | 指定用の語                              |
| compress  | UNIX compress（LZW）       | RFC 9110          | 主要ブラウザは送らない                        |

ブラウザ対応の版は、2026年10月25日に取得したMDNの互換性データ（browser-compat-data）の値です。`x-gzip`・`x-compress`は旧名として非推奨扱いになっています。

### deflateを避ける理由

RFC 9110の定義では、`deflate`は「zlib形式で包んだdeflateデータ」です。ところが同じ節に、zlibのヘッダを付けずに生のdeflateデータを送る非準拠の実装があると注記されています。受け手が片方の形式しか読めないと解凍に失敗するため、サーバー側で新たにdeflateを出す理由はありません。gzipで足ります。

### zstdの8MB窓と共有辞書（dcb・dcz）

IANAの登録ではzstdは「Window\_Sizeが8MB以下」のストリームと定義されています（RFC 9659）。RFC 9659は、送り手に8MBを超える窓を使わないこと、受け手に8MBまでの窓に対応することを義務づけています。圧縮レベルを上げすぎて窓が8MBを超えた出力は規定違反で、受け手が解凍できる保証はありません。サーバーやCDNでzstdを有効にするときは、出力の窓が8MB以下に収まる設定か確認してください。

dcbとdczは、以前に配信したファイルを辞書として差分だけを圧縮する方式（Compression Dictionary Transport）です。JavaScriptのバンドルを頻繁に更新するサイトで効きます。通常の設定で送ってくるのはChrome 130以降などのChromium系で、Firefoxは145以降で設定（`network.http.dictionaries.enable`）を有効にした場合に限られます。

## 書式とq値・identity・ヘッダ無しの解釈ルール

### q値で優先順位を付ける書き方

値はカンマ区切りで並べ、各値に`;q=`で0から1の重みを付けられます。重みを省略すると1です。並び順自体には優先度の意味はなく、比べるのはq値です。

```
Accept-Encoding: br;q=1.0, gzip;q=0.8, *;q=0.1
Accept-Encoding: gzip;q=1.0, identity; q=0.5, *;q=0
```

1行目は「Brotliが最優先、次にgzip、それ以外も一応可」。2行目はRFC 9110の例で「gzipを優先、非圧縮も可、それ以外は不可」を意味します。`*`はヘッダに明示していないすべてのコーディングにマッチします。`q=0`は「受け付けない」の意味で、小数点はピリオドです（`q=1,0`のようなカンマは書式エラー）。

### identity・空値・ヘッダ無しの違い

似ているようで、RFC 9110では扱いがはっきり分かれています。

| リクエスト                                      | RFC 9110での意味     |
| ------------------------------------------ | ---------------- |
| ヘッダ無し                                      | どのコーディングでも受け入れ可能 |
| Accept-Encoding:（空）                        | コーディングを使わないでほしい  |
| Accept-Encoding: identity                  | 非圧縮を希望           |
| identity;q=0、またはidentityの個別指定がない場合の \*;q=0 | 非圧縮を拒否           |

「ヘッダを付けなければ非圧縮で返ってくる」という解説は仕様上は逆で、ヘッダ無しは「何でもよい」です。多くの環境で非圧縮になるのは、nginxもApacheもAccept-Encodingに方式が載っていない限り圧縮しないという実装側の慎重さによります。確実に非圧縮で受け取りたいクライアントは`Accept-Encoding: identity`を送ってください。

どの圧縮方式も一致しなかった場合、サーバーは406を返すのではなく非圧縮で返すべき（SHOULD）とされています。例外は`identity;q=0`などで非圧縮まで拒否されたときだけです。

### q=0で拒否しても圧縮して返すサーバー（実測）

RFC 9110の判定規則では、Accept-Encodingに載っていてもq値が0の方式は受け入れ不可です。この規則が守られているかを、2026年10月25日に5つのサイトのトップページなどへ、下の3種類のヘッダを同じ条件で2回ずつ送って確かめました。2回とも結果は同じでした。

| 送ったAccept-Encoding | Cloudflare | MDN  | nginx.org | Google | GitHub |
| ------------------ | ---------- | ---- | --------- | ------ | ------ |
| gzip;q=0           | gzip       | gzip | 非圧縮       | 非圧縮    | 非圧縮    |
| br;q=0, gzip;q=0.5 | br         | br   | gzip      | gzip   | gzip   |
| identity           | 非圧縮        | 非圧縮  | 非圧縮       | 非圧縮    | 非圧縮    |

Cloudflare（www.cloudflare.com）とMDN（Google Frontend経由のVarnish）は、q=0を付けた方式でも名前が載っていれば使いました。`identity`だけを送った場合はどのサイトも非圧縮です。RFC 9110の上ではq=0は正規の拒否指定ですが、このとおり守らない配信基盤があります。解凍できない方式はq=0で打ち消すより最初から書かないほうが誤配信の余地が小さく、それでも想定外の方式が届く可能性は残るので、受け取った側は`Content-Encoding`を見て分岐してください。

## ブラウザとHTTPクライアントが実際に送る値

### 主要ブラウザの既定値

[MDNのAccept-Encodingのページ](https://developer.mozilla.org/ja/docs/Web/HTTP/Reference/Headers/Accept-Encoding)は、ブラウザのページ遷移で送られる典型値を`gzip, deflate, br, zstd`としています。zstdが加わったのはChrome 123、Firefox 126からで、SafariはmacOS 26.3 Tahoeより前ではzstdを送りません。Edgeは同じChromiumなのでChromeと同じ値です。手元のChrome 155（ヘッドレス）でローカルサーバーを開いたときも`gzip, deflate, br, zstd`でした。

この値は接続の種類でも変わります。Firefoxのソース（`modules/libpref/init/all.js`）では、平文のhttpで送るのは`gzip, deflate`だけで、httpsのときに`br, zstd`が加わり、圧縮辞書機能が有効で使える辞書があれば`dcb`・`dcz`も付きます。brやzstdを配信する場合も、zstdを送らないSafari 26.2以前などのクライアントにgzipで返せるよう、gzipの設定は残しておくのが安全です。

ブラウザのJavaScriptからこの値は変えられません。[Fetch Standard](https://fetch.spec.whatwg.org/#forbidden-request-header)はAccept-Encodingを「forbidden request-header」に挙げており、`fetch()`や`XMLHttpRequest`でヘッダを指定しても送信時にはブラウザの値が使われます。圧縮方式を変えて試したいときは、curlやサーバー側のコードで確かめます。開発者ツールのリクエストをcurlに写す手順は[Copy as cURLの使い方｜Chrome DevToolsでリクエストを再現する手順とcmd・bash・fetchの違い](/tech/details/12635/)で解説しています。

### curl・Python・Node.js・Javaの既定値（実測）

受け取ったヘッダを記録するだけのローカルサーバーへ各クライアントからリクエストを送り、Accept-Encodingの値を確かめました（Python 3.14の行は2026年10月25日、ほかは2026年9月28日）。

| クライアント                           | 既定で送る値                  | gzipの自動解凍 |
| -------------------------------- | ----------------------- | --------- |
| curl 8.7.1（オプションなし）              | 送らない                    | しない       |
| curl 8.7.1 `--compressed`        | deflate, gzip           | する        |
| Python urllib（3.9・3.14）          | identity                | しない       |
| requests 2.32.5（Python 3.9）      | gzip, deflate           | する        |
| requests 2.34.2（Python 3.14）     | gzip, deflate, zstd     | する        |
| 同上＋brotliパッケージ                   | gzip, deflate, br, zstd | する        |
| Node.js v26.5.0 fetch（http）      | gzip, deflate           | する        |
| Node.js v26.5.0 fetch（https）     | br, gzip, deflate, zstd | する        |
| Java 25 java.net.http.HttpClient | 送らない                    | しない       |
| Apache HttpClient 5.6.4          | gzip, deflate, x-gzip   | する        |

curlの`--compressed`が送る値は、curlがビルド時に組み込んだライブラリで決まります。上の8.7.1はBrotliとzstdなしでビルドされていたため`deflate, gzip`だけでした。requestsの値は下層のurllib3が、その環境で使える解凍手段から組み立てます。[urllib3の変更履歴](https://github.com/urllib3/urllib3/blob/main/CHANGES.rst)によると、2.5.0でPython 3.14の標準モジュール`compression.zstd`に対応しました。そのためPython 3.14では追加のパッケージなしで`zstd`が加わり、Python 3.9の同じコードとは値が変わります。Node.jsのfetchは平文のhttpではbrとzstdを送らないので、ローカル開発環境と本番のhttpsで返る圧縮方式が変わる点にも注意してください。

## Content-Encoding: br・zstdで返ってきたときの解凍可否

前章のq=0の例のように、サーバーがAccept-Encodingに無い方式で返してくることはあります。そこでローカルのNode.jsサーバーから、1,200バイトの本文をbr・zstdで圧縮して返し、各クライアントがどう受け取るかを2026年10月25日に確かめました。

| クライアント                       | br で返ってきたとき   | zstd で返ってきたとき |
| ---------------------------- | ------------- | ------------- |
| Chrome 155                   | 解凍して表示        | 解凍して表示        |
| Node.js v26.5.0 fetch        | 解凍（1,200文字）   | 解凍（1,200文字）   |
| curl 8.7.1 `--compressed`    | 終了コード61で中断    | 終了コード61で中断    |
| requests 2.32.5（Python 3.9）  | 圧縮データ21バイトのまま | 圧縮データ23バイトのまま |
| requests 2.34.2（Python 3.14） | 圧縮データ21バイトのまま | 解凍（1,200バイト）  |
| 同上＋brotliパッケージ               | 解凍（1,200バイト）  | 解凍（1,200バイト）  |

curlは`curl: (61) Unrecognized content encoding type. libcurl understands deflate, gzip content encodings.`と表示して止まるので、原因にすぐ気づけます。危ないのはrequestsのほうで、例外を出さずに圧縮されたバイト列を`r.content`に入れて返しました。`r.json()`で初めて失敗するため、エラーの場所が圧縮だと分かりにくくなります。CDNを挟んだAPIを呼ぶPythonのコードでは、`pip install brotli`でBrotliを解凍できるようにしておくか、受け取った`Content-Encoding`が想定外なら例外にする処理を入れてください。外部APIとの接続部分をまとめて設計し直す場合は、[API開発・システム連携](/service/system/api/)の支援も行っています。

## 圧縮されているかを確認する手順

### ブラウザの開発者ツールで見る場所

開発者ツールのNetworkタブでページを再読み込みし、対象のリクエストを選びます。「Response Headers」に`content-encoding: br`などがあれば圧縮されています。一覧の転送サイズと展開後のサイズの差が、圧縮の効き具合の目安です。

### curlによる応答ヘッダと転送サイズの比較

圧縮の有無と効果を数字で見るなら、`-w '%{size_download}'`で受信バイト数を出し、Accept-Encodingを変えて比べるのが確実です。

```
URL=https://developer.mozilla.org/ja/docs/Web/HTTP/Reference/Headers/Accept-Encoding
for ae in identity gzip br zstd; do
  curl -s -o /dev/null -D - -H "Accept-Encoding: $ae" \
    -w "$ae: %{size_download} bytes\n" "$URL" | grep -i -E "content-encoding|bytes"
done
```

2026年9月28日にMDNの本ページで実行すると、identityが244,508バイト、gzipが30,377バイト、brが25,275バイトでした。gzipで約8分の1、Brotliはgzipよりさらに約17%小さくなっています。zstdを指定したリクエストは244,508バイトの非圧縮で返り、`Content-Encoding`も付きませんでした。対応しない方式を求められたサーバーが非圧縮で返す、RFC 9110のルールどおりの動きです。

`-I`はHEADリクエストを送るため、GETと違う応答を返すサーバーでは判断を誤ります。`-o /dev/null -D -`でGETのヘッダを見るほうが安全です。また[curlのマニュアル](https://curl.se/docs/manpage.html)には、`--compressed`で保存したヘッダには解凍後も`Content-Encoding`が残ると明記されています。

## 解凍エラー（ERR\_CONTENT\_DECODING\_FAILED）の原因と切り分け

Chromeの`ERR_CONTENT_DECODING_FAILED`、Firefoxの「内容符号化 (Content-Encoding) に問題があります」（英語版はContent Encoding Error）は、`Content-Encoding`ヘッダと本文の中身が食い違っているときに出ます。ローカルのNode.jsサーバーで2つの壊れ方を再現し、2026年10月25日に各クライアントの反応を記録しました。

| 壊れ方               | Chrome 155                     | curl `--compressed`         | Node.js fetch             | requests             |
| ----------------- | ------------------------------ | --------------------------- | ------------------------- | -------------------- |
| gzipと宣言して非圧縮の本文   | ERR\_CONTENT\_DECODING\_FAILED | (61) incorrect header check | TypeError（Z\_DATA\_ERROR） | ContentDecodingError |
| gzipを二重にかけてヘッダは1つ | ファイルとしてダウンロード                  | gzipデータ36バイトを保存             | gzipデータのまま返す              | gzipデータのまま返す         |

1つ目は、アプリが`Content-Encoding: gzip`を自分で付けたのに圧縮していない場合や、途中のプロキシが本文を解凍したのにヘッダを残した場合に起きます。2つ目は、アプリとWebサーバー（またはCDN）の両方で圧縮した場合で、エラーにならず中身が化けたまま届くので気づきにくい壊れ方です。

切り分けは、curlに`--compressed`を付けずに本文を取り、先頭のバイトを見るのが早道です。先頭の`1f8b`はgzipの識別子にすぎないので、データ全体が正しいかは`gzip -t`で検査します。

```
curl -s -D - -o body.bin -H "Accept-Encoding: gzip" https://example.com/api | grep -i content-encoding
head -c 4 body.bin | xxd
# 1f8b でない → ヘッダだけgzip（1つ目の壊れ方）
gzip -t body.bin && echo ok
# 1f8b で始まっても途中で切れたデータは -t で失敗する
gzip -dc body.bin | head -c 4 | xxd
# 解凍後もまた 1f8b → 二重圧縮（2つ目の壊れ方）
```

オリジンに直接送ったときは正常で、CDNやリバースプロキシを通すと壊れるなら、中継側を疑います。比べるのは、両経路の応答の`Content-Encoding`・`Vary`・キャッシュ状態のヘッダ（Cloudflareなら`cf-cache-status`、一般には`Age`）と、中継がオリジンへ転送しているAccept-Encodingの値です。キャッシュ済みの古い応答が返っているだけなら、キャッシュを消すと直ります。中継の構成は[リバースプロキシとは？仕組み・フォワードプロキシとの違いと導入判断](/tech/details/13554/)で整理しています。

## サーバー側の設定：nginxの既定値とVary

### nginxのgzip設定で確認する5つの既定値

nginxのngx\_http\_gzip\_moduleは`gzip on;`だけでは期待どおりに動かないことがあります。[公式ドキュメント](https://nginx.org/en/docs/http/ngx%5Fhttp%5Fgzip%5Fmodule.html)の既定値は次のとおりです。

| ディレクティブ           | 既定値       | 困る場面                        |
| ----------------- | --------- | --------------------------- |
| gzip\_types       | text/html | CSS・JS・JSONが圧縮されない          |
| gzip\_vary        | off       | Vary: Accept-Encodingが付かない  |
| gzip\_proxied     | off       | CDN経由（Viaヘッダ付き）のリクエストを圧縮しない |
| gzip\_comp\_level | 1         | 圧縮率が最低                      |
| gzip\_min\_length | 20        | 極小のレスポンスまで圧縮する              |

特に見落としやすいのが`gzip_proxied off`です。nginxはViaヘッダの有無でプロキシ経由かを判定するため、Viaを付けるCDNの背後に置くと、オリジンで圧縮されずに届きます。CDN側で圧縮し直す設定がなければ、利用者には非圧縮のまま配信されます。

```
gzip on;
gzip_types text/plain text/css application/javascript application/json image/svg+xml;
gzip_vary on;
gzip_proxied any;
gzip_comp_level 5;
gzip_min_length 1024;
```

nginx（オープンソース版）の標準モジュールにはBrotliとzstdが無く、サードパーティ製モジュール（ngx\_brotliなど）を組み込むか、CDN側に任せることになります。商用版のNGINX Plusは、[公式リポジトリのnginx-plus-module-brotli](https://docs.nginx.com/nginx/admin-guide/dynamic-modules/brotli/)でBrotliを追加できます。Apache httpdはgzipを`mod_deflate`で、Brotliを2.4.26以降の[mod\_brotli](https://httpd.apache.org/docs/2.4/mod/mod%5Fbrotli.html)で扱えます。

### Vary: Accept-Encodingとキャッシュの取り違え

同じURLでもAccept-Encodingによって本文が変わるため、中間キャッシュには「このヘッダごとに別のキャッシュとして持て」と伝える必要があります。それが`Vary: Accept-Encoding`です。これが無いと、Brotli版がキャッシュされた後にBrotli非対応のクライアントへ同じものが返ります。ブラウザなら前章の解凍エラーになり、requestsのように圧縮データを黙って返すクライアントでは後段のJSON解析などで失敗します。nginxでは`gzip_vary on;`が必要です。

CDNのキャッシュキーの考え方は[CDNとは？仕組み・キャッシュ制御からサービスの選び方まで](/tech/details/13095/)、キャッシュの再検証は[stale-while-revalidateとは？Cache-Controlの設定例とCDN別の挙動](/tech/details/7774/)で扱っています。

## Java標準HttpClientの手動解凍と応答判定

### java.net.http.HttpClientでgzipを受け取るコード

Java 11以降の`java.net.http.HttpClient`は、Accept-Encodingを自動では付けません。自分でヘッダを付け、サーバーがgzipを選択して返した場合も、クライアントは解凍しないため、そのまま文字列にすると壊れたバイト列になります。2026年9月28日にローカルサーバー（1,200バイトの本文を返す）で試すと、36バイトのgzipデータのまま渡されました。`Content-Encoding`を見て自分で`GZIPInputStream`を被せます。

```
import java.io.IOException;
import java.io.InputStream;
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.nio.charset.StandardCharsets;
import java.util.List;
import java.util.zip.GZIPInputStream;

public class GzipFetch {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        HttpRequest req = HttpRequest.newBuilder(URI.create(args[0]))
                .header("Accept-Encoding", "gzip")
                .build();
        HttpResponse<InputStream> res =
                client.send(req, HttpResponse.BodyHandlers.ofInputStream());
        int status = res.statusCode();
        if (req.method().equals("HEAD") || status == 204 || status == 304) {
            res.body().close();
            System.out.println(status + " / no body");
            return;
        }
        List<String> values = res.headers().allValues("Content-Encoding");
        String enc = values.isEmpty() ? "identity" : String.join(", ", values);
        try (InputStream in = decode(res.body(), enc)) {
            String text = new String(in.readAllBytes(), StandardCharsets.UTF_8);
            System.out.println(enc + " / " + text.length() + " chars");
        }
    }

    static InputStream decode(InputStream raw, String enc) throws IOException {
        try {
            if (enc.equalsIgnoreCase("gzip")) {
                return new GZIPInputStream(raw);
            }
            if (enc.equalsIgnoreCase("identity")) {
                return raw;
            }
            throw new IOException("unsupported Content-Encoding: " + enc);
        } catch (IOException e) {
            raw.close();
            throw e;
        }
    }
}
```

Java 25（25.0.4.1）で同じサーバーに送ると`gzip / 1200 chars`と出力され、正しく解凍できました。Accept-Encodingに書くのは、実際に解凍処理を持っている方式だけにしてください。解凍できない`br`まで並べると、サーバーがBrotliを選んだ時点で例外になります。

もう1つの落とし穴はHEADリクエストや204・304の応答です。本文が空でも`Content-Encoding: gzip`が付くことがあり、分岐を入れる前のコードでHEADを送ったところ`GZIPInputStream`の生成時に`EOFException`が発生しました。上のコードはHEAD・204・304を先に判定して解凍を通しません（HEADを送るように書き換えて試すと`200 / no body`と出力されました）。解凍の準備で例外が出たときも受信ストリームを閉じるよう、`decode`に分けています。

`Content-Encoding`は`allValues`で全行を取ります。`firstValue`では、ヘッダが2行に分かれた二重圧縮の応答で1回だけ解凍してしまうためです。2026年10月25日にこの版で試すと、2行の`Content-Encoding: gzip`を返す応答と、gzipしか求めていないのにbrで返す応答は、どちらも`unsupported Content-Encoding`の例外で止まりました。

### Apache HttpClient 5とSpringのRestClient

Apache HttpClient 5（5.6.4で確認）は、リクエストにAccept-Encodingが無ければ`gzip, deflate, x-gzip`を自動で付け、応答も自動で解凍します。Brotliなどは、対応するデコーダのライブラリがクラスパスにあるときだけ候補に加わる実装です。

SpringのRestClientやRestTemplateが解凍するかどうかは、下層に使うHTTPクライアントで決まります。Apache HttpClient 5を下層にすれば自動解凍が効きます。下層の選び方は[SpringのRestClientとは？使い方とRestTemplate非推奨後の移行](/tech/details/3311/)で解説しています。

## 圧縮しないほうがよい場面

1つ目はBREACH攻撃（CVE-2013-3587）の条件がそろうレスポンスです。[発見者のサイト](https://www.breachattack.com/)によると、成立条件は「HTTPレベルで圧縮している」「ユーザー入力を本文に反映する」「CSRFトークンなどの秘密を本文に含む」の3つです。攻撃者はレスポンスのサイズ変化から秘密を1文字ずつ推測します。3条件がそろうページでは、トークンをリクエストごとにランダム化するかマスクする、あるいはそのレスポンスだけ圧縮を切ります。静的なCSSやJSにこの心配はありません。

2つ目はJPEG・PNG・WebP・MP4・ZIP・PDFなど、すでに圧縮されている形式です。再圧縮してもほとんど縮まず、CPUを使うだけです。nginxの`gzip_types`にこれらを入れないでください。

3つ目は数百バイト程度の小さなレスポンスです。gzip形式はヘッダ10バイトとトレーラ8バイトを必ず持つため（RFC 1952）、縮む量がわずかです。nginxの既定値20バイトではほぼすべての応答が圧縮対象になるため、実際の応答サイズの分布を見て閾値を上げます（上の設定例では1024バイト）。

## Accept-Encodingに関するよくある質問

### accept-encoding: identity とはどういう意味ですか？

「圧縮せずにそのまま送ってほしい」という指定です。identityはRFC 9110で予約された語で、符号化なしを表します。Python標準のurllibは既定でこの値を送ります。逆に`identity;q=0`と書くと非圧縮での応答も拒否することになります。どの方式も合わなかったとき、サーバーは406を返すか、指定を無視して既定の表現を返すかを選ぶことになり、結果が読めなくなるため通常は使いません。

### gzip, deflate, br, zstd はそれぞれどう違いますか？

gzipは最も互換性が高い標準的な方式、brはGoogleが開発したBrotliでgzipより小さくなり、zstdはMeta（旧Facebook）が開発したZstandardで圧縮と解凍が速いのが特徴です。deflateはgzipと同系統ですが実装差があり、新規に使う理由はありません。ブラウザがこの4つを並べて送り、サーバーが対応するものから1つを選びます。

### Accept-Encodingを指定しないとどうなりますか？

RFC 9110ではヘッダ無しは「どのコーディングでも受け入れ可能」と解釈されます。ただしnginxやApacheはAccept-Encodingに載った方式しか使わないため、実際には非圧縮で返ることがほとんどです。Java標準のHttpClientやオプションなしのcurlはヘッダを送らないので、転送量を減らしたいなら明示的に付けて、解凍処理も用意してください。

### Accept-Encoding: none と書くとどうなりますか？

`none`はIANAに登録されたコーディング名ではないため、サーバーから見ると「知らない方式が1つ書かれているだけ」です。一致する方式が無いので、RFC 9110のルールどおり非圧縮で返ります。2026年10月25日にq=0の計測と同じ5サイトへ送った結果も、すべて`Content-Encoding`無しの非圧縮でした。非圧縮を求める意図なら、正式な`identity`を使ってください。

### curlで圧縮されたレスポンスを確認するには？

`curl -s -o /dev/null -D - -H "Accept-Encoding: gzip" URL`でレスポンスヘッダを表示し、`Content-Encoding: gzip`があれば圧縮されています。本文も読みたいときは`--compressed`を付けると自動で解凍されます。brで返すサーバーを確かめるときは、`curl -V`のFeatures行に`brotli`があるかを先に見てください。無いcurlで`--compressed`を付けても、brの応答は解凍できません。

## 関連記事

- [CDNとは？仕組み・キャッシュ制御からサービスの選び方まで実装目線で解説](/tech/details/13095/)
- [stale-while-revalidateとは？Cache-Controlの設定例とReact SWR・CDN別の挙動を解説](/tech/details/7774/)
- [Copy as cURLの使い方｜Chrome DevToolsでリクエストを再現する手順とcmd・bash・fetchの違い](/tech/details/12635/)
- [SpringのRestClientとは？使い方とRestTemplate非推奨後の移行【Spring Boot 4対応】](/tech/details/3311/)
- [QUIC（通信プロトコル）とは？HTTP/3を支える仕組みとTCPとの違いを実装視点で解説](/tech/details/16234/)

---

出典: [Accept-Encodingとは？gzip・br・zstdの指定とContent-Encodingとの違い](<https://www.issoh.co.jp/tech/details/6855/>)（株式会社一創）
