2026 Next.js 16.1 PPRはCloudflare Workers上で自動的に分割転送エンコーディングを使用しますか?

Cloudflareの公式資料では、ReadableStreamをレスポンス本文に使うとストリーミング応答になり、分割転送エンコーディングが使われると説明されています。したがって、Workersがストリーミングに対応していることは確認できますが、それだけではNext.js 16.1 PPRの障害原因とは判断できません。要求経路、応答プロトコル、本文が最後まで届くかを同じ条件で確かめてから、アプリやデプロイ設定を変更してください。WorkersのStreams仕様も参照できます。
対象は、Next.js 16.1 PPRとCloudflare Workersの応答挙動を調査するフロントエンド・フルスタック開発者です。
エッジ環境の運用担当者は、再現試験の設計に役立てられます。共有開発環境を検討する技術責任者にも向きますが、Macの開発環境はWorkersの実行環境の代替ではありません。
公式の転送仕様と障害原因の切り分け
「ストリーミング応答であること」と「ブラウザーで本文が最後まで表示されること」は同じ意味ではありません。中継するWorkerやアダプターが本文を読み取って再構成すれば、転送のされ方が変わる可能性があります。具体的な動作は、実際のコードとデプロイ経路で確かめる必要があります。
分割転送はHTTP/1.1のメッセージ転送方式です。RFC 9112の分割転送に関する仕様では、HTTP/1.1のメッセージ本文を分割して転送する仕組みが定義されています。要求で別のプロトコルが使われている場合、Transfer-Encodingヘッダーの有無だけでストリームの成否を判定しないでください。
| 観測した事実 | そこから判断できること | それだけでは判断できないこと |
|---|---|---|
| 直接のWorkers応答で本文が順次届く | その要求経路ではストリーミングを確認できる | PPRの動的部分が常に正常に完了するか |
HTTP/1.1応答にTransfer-Encoding: chunkedがある |
その応答区間で分割転送が使われている | アプリが障害を起こしたのか、中継層が影響したのか |
| ヘッダーが見当たらない | その観測だけでは転送方式を確定できない | 本文がバッファーされた、またはストリームが停止したという結論 |
ブラウザーからの直接要求
最初に、問題が出るページをブラウザーから直接開きます。開発者ツールでステータス、応答ヘッダー、選択されたプロトコル、本文が完了するかを記録してください。静的な部分だけ表示され、動的な箇所が待ち続ける場合も、そこで観測したのはその要求の結果です。すべてのWorkers環境に共通する挙動だとは言えません。
続けて、可能なら同じURLをHTTP/1.1で取得し、応答ヘッダーと本文の終了を確かめます。たとえばcurl --http1.1 -sS -D - URL -o body.binでヘッダーを保存できます。接続先、認証状態、クエリ、要求ヘッダーをそろえ、プロトコルが異なる場合の結果は別々に記録します。
Transfer-Encoding: chunkedがあれば、その応答の転送方式を確認する材料になります。ただし、ヘッダー単独ではPPRの処理や切断箇所を特定できません。
中継処理の有無
ブラウザーからの直接要求で再現しない場合は、デプロイ経路に含まれるアダプターや独自Workerを調べます。次の処理があるか、コードと設定を確認してください。
response.bodyを読み切って文字列やバイト列に変換していないか。- 新しい
Responseを作る際、本文をそのまま渡しているか、加工しているか。 - ログ、HTML変換、セキュリティ処理などが本文を先に読み取っていないか。
- デプロイ設定やアダプターのバージョンが、調査対象の環境と一致しているか。
本文を変換しているから必ずストリームが止まる、あるいは同じReadableStreamを渡しているから必ず最後まで届く、とは決めつけられません。アダプター固有の動作を述べる場合は、該当バージョンの公式資料や再現記録を根拠にします。Workersでの応答オブジェクトの扱いは、CloudflareのResponse API資料で確認できます。
キャッシュと圧縮の比較
キャッシュと圧縮は、障害の原因と決めつけず、切り分け条件として扱います。同じパスでキャッシュ命中・未命中を比べ、次に圧縮を有効・無効にして応答本文と完了状態を記録します。要求ごとに条件を一つだけ変えると、どの差が結果に関係したか追いやすくなります。
キャッシュ状態の調査にはCloudflareのキャッシュ応答確認手順、圧縮の挙動にはCloudflareのコンテンツ圧縮の説明を参照してください。圧縮方式やキャッシュ状態の差が見つかっても、それだけでPPRとの因果関係は確定しません。
Next.js 16のPPR設定
Next.js 16の公式アップグレードガイドでは、cacheComponentsによってPPRを有効にする構成が案内されています。また、従来の実験的PPRフラグと設定項目は削除対象として説明されています。Next.js 16のアップグレードガイドを基準に、実際に稼働している設定とビルド成果物を確認してください。
この変更は、旧版のexperimental_pprをそのまま比較条件に使えないことを意味します。以前の設定を残したままのデプロイと、現行の設定に移行したデプロイを混同せず、Next.jsのバージョン、設定、アダプターを記録します。設定変更だけで転送障害が直ると予測するのではなく、同じ経路で結果を比べてください。
502・504の発生元
ステータスコードだけでは、Cloudflare側とアプリ側のどちらがエラーを返したかを確定できません。応答本文やヘッダー、Workerと上流側のログを照合します。Cloudflareの502・504エラー診断資料では、エラーの発生元や上流との通信状況を分けて調査する方法が説明されています。
Cloudflareのエラー表示があるか、アプリのログに同じ要求の失敗が残っているかを分けて記録します。ステータスが502でも、直ちにEdge RuntimeのNode.js Streams API非対応やReactの不具合を原因とみなすことはできません。そのような説明には、該当環境での再現や、対象バージョンの公式な制限記載が必要です。
再現条件をそろえる手順
次の順序で観測すると、推測と確認済みの事実を分けられます。
- 対象を固定します。 問題が出るURL、認証状態、要求ヘッダー、デプロイ先を記録します。
- PPRの状態を記録します。 Next.jsのバージョンと
cacheComponentsなどの設定を保存します。 - 直接要求を調べます。 ブラウザーと、利用できる場合はHTTP/1.1の要求で、ステータス、ヘッダー、本文の終了を記録します。
- 中継処理を追います。 アダプターや独自Workerが本文を読み取り、変換、バッファー、再構成しているかをコードで確認します。
- キャッシュと圧縮を一条件ずつ比べます。 要求条件を保ち、命中・未命中、圧縮の有効・無効ごとに結果を残します。
- 同じ経路で対照します。 同じルート、同じ要求条件、同じデプロイ経路でPPR有効時と無効時を比べます。PPRを一時停止するのは、その比較が差を示した場合に限ります。
- 変更後に再検証します。 回避策を入れたら同じ要求を再実行し、本文の完了まで改善したかを確かめます。
一度だけ成功した応答は、恒常的な解決の証明にはなりません。要求条件、観測結果、変更点を一組で残すと、後から原因を追いやすくなります。
結果に応じた判断
- 直接要求でも中継経由でも本文が完了し、差が再現しない場合は、分割転送を根因として扱わず、観測を続けます。
- 直接要求は完了し、中継経由だけ停止する場合は、アダプターや独自Workerの本文処理を優先して調査します。
- キャッシュまたは圧縮の条件を変えたときだけ差が再現する場合は、その条件とログを保存し、対応する設定を一つずつ検証します。
- PPRを無効にした同一路線だけで改善する場合は、暫定的な回避策として検討できます。ただし、比較条件が一致していることを確認してから適用します。
- どの条件でも再現しない場合は、一般的なプラットフォーム制限と結論づけず、未確認の仮説として残します。
現状の開発環境で設定合わせを繰り返す必要があったり、チーム間で再現手順や作業状態を共有しにくかったりするなら、共有できるMac開発ワークスペースが役立つ場合があります。ProxyMacの利用条件はヘルプで確認し、必要な期間や利用形態に合うかは日本向け料金案内で比較できます。MacはNext.jsのビルドや開発環境の共有には使えますが、Cloudflare Workersの本番実行環境そのものではありません。