RSC Payloadは、Next.jsのApp Routerがサーバーからブラウザへ送っている、Server Componentsの描画結果そのものです。この記事では、Next.js 16.4.4とReact 19.3.1で小さなアプリをビルドし、実際に取り出したペイロードを材料にして、行の書式と$Lなどの記号の読み方、curlで取得するときの注意、コンソールに出る「Failed to fetch RSC payload」の原因、ペイロードを膨らませない設計、Flightプロトコルの脆弱性と修正版までを扱います。根拠はNext.js公式ドキュメントとNext.js・React本体のソースコードです。RSC自体の考え方はReact Server Components(RSC)とは?サーバーとクライアントの違い・使い分けと確認方法【React 19.3】で先に押さえておくと読みやすくなります。
まとめ:RSC Payloadの要点
- 正体:描画済みのServer Componentツリーを直列化したデータ。HTMLではなく、JSONを拡張したReactの内部プロトコル(Flight)の行の連なりで、Content-Typeは
text/x-componentです。 - 取り出し方:初回ロード分はHTML内の
self.__next_fに、画面遷移分はrsc: 1ヘッダ付きリクエストの応答に入っています。curlで叩くと_rscクエリの検証で307が返るため、-Lを付けます。 - 読み方:各行は「16進ID+コロン+タグ+本体」。
I行はClient Componentの読み込み情報、$L7は7番の行への参照、$@bはPromiseです。 - エラー:「Failed to fetch RSC payload」は、取得のfetchかFlightの読み取りが例外になったときだけ出ます。Next.jsは通常のページ遷移へ切り替えますが、通信断やサーバー障害が続いている場合は画面を開けないこともあります。
- 注意点:Client Componentへ渡したpropsは、画面に出していない項目も全部ペイロードに載ります。Flightの読み取り処理には2025年12月以降に10件の脆弱性が出ており、
react-server-dom-*は各系列で19.0.9/19.1.10/19.2.9/19.3.1以降が必要です。Next.jsはこれを同梱しているので、next自体を対応版へ上げます。
RSC Payloadの定義とHTMLとの役割分担
公式定義に書かれている3つの中身
Next.js公式ドキュメントのServer and Client Components(docs version 16.4.4、最終更新2026年10月5日)は、RSC Payloadを「描画されたReact Server Componentsツリーのコンパクトな直列化表現(compact, serialized representation)」と定義し、中身を3つ挙げています。Server Componentの描画結果、Client Componentを描画する位置のプレースホルダとそのJavaScriptファイルへの参照、Server ComponentからClient Componentへ渡されたpropsです。以前の版は「binary representation」と書いていましたが、実物は後述のとおり大半がテキストの行です。
見落とされやすいのは3つ目です。propsはClient Componentの入力であると同時に、ネットワークを流れる公開データでもあります。
初回ロードと画面遷移での使われ方の違い
初回アクセスではHTMLとRSC Payloadの両方が届きます。HTMLは操作できないプレビューをすぐ表示するため、RSC PayloadはClient ComponentツリーとServer Componentツリーを突き合わせる(reconcile)ために使われ、そのあとJavaScriptがClient Componentをハイドレートします。App Router内の画面遷移ではHTMLは発行されず、RSC Payloadだけがプリフェッチ・キャッシュされます。「同じページなのに初回とリンク遷移で応答の中身が違う」のはこのためです。ハイドレーションの不一致を追うときに見るべきは初回ロード側のペイロードで、原因の切り分けはハイドレーションエラー(Hydration Error)とは?React 19のエラー文・#418の読み方と原因別の直し方にまとめています。
ブラウザとcurlでRSC Payloadを取り出す手順
初回ロードのHTML内にあるペイロード断片の結合
初回ロードのペイロードは、HTML内のscriptタグでself.__next_f.push()により少しずつ積まれます。実測したトップページのHTMLでは、最初に(self.__next_f=self.__next_f||[]).push([0])があり、続いてpush([1,"..."])が4回並んでいました。先頭要素は0が初期化、1がテキストの断片、2がフォームの状態、3がBase64化したバイナリの断片です(app-index.tsx)。ただし同じファイルは、読み込んだ直後に__next_fの中身を処理して配列を空にし、以後のpushも配列に残さず直接処理します。そのため__next_fを後から読んでも何も取れません。次のコードはロード完了後にDOM内のscriptからテキスト断片を結合し、バイナリ断片があれば処理を停止します。
Array.from(document.scripts).flatMap(script => {
const text = script.textContent.trim();
const prefix = 'self.__next_f.push(';
if (!text.startsWith(prefix)) return [];
const seg = JSON.parse(text.slice(prefix.length, text.lastIndexOf(')')));
if (seg[0] === 3) {
throw new Error('バイナリ断片を含むためテキスト結合の対象外です');
}
return seg[0] === 1 ? [seg[1]] : [];
}).join('')
画面遷移:rscヘッダと _rsc クエリ
Next.jsのソースapp-router-headers.ts(v16.4.4)が定義しているとおり、App Router内の遷移ではリクエストにrsc: 1と現在のルーター状態を表すnext-router-state-treeが付き、応答のContent-Typeはtext/x-componentになります。DevToolsのNetworkパネルのフィルタ欄は既定でURLを検索するため、MIMEタイプで絞るにはmime-type:text/x-componentと入力します。
URL末尾の?_rsc=HEAvJdHAQJrUAe2Kのような値は、これらのリクエストヘッダの値から作ったハッシュです。公式ガイドCDN Cachingによると、Varyを無視するCDNでもHTMLとRSC Payloadが別のキャッシュキーになるように付けています。サーバーがペイロードを返すかどうかを決めているのはrscヘッダのほうです。
curl取得時の307リダイレクトと-Lによる追従
Next.js 16.4.4では、rsc: 1だけを付けて_rscの無いURLを叩くと、サーバーは正しいハッシュ付きのURLへ307リダイレクトを返します。これはexperimental.validateRSCRequestHeaders(config-shared.tsの既定値はtrue)による検証で、ハッシュの不一致を放置するとCDNでキャッシュ汚染が起きうるためとソースのコメントに書かれています。-Lを付けないと、本文が空のまま終わります。
curl -s -L -D - http://localhost:3000/ -H 'rsc: 1'
実測では、まずHTTP/1.1 307とlocation: /?_rscが返り、リダイレクト先で200 OK・Content-Type: text/x-component・Vary: rsc, next-router-state-tree, next-router-prefetch, next-router-segment-prefetchが付いた応答になりました。next-router-prefetch: 1も付けると、リダイレクト先は?_rsc=HEAvJdHAQJrUAe2Kのような値に変わります。わざと違う値(?_rsc=abc)を付けた場合も307で正しい値へ送り返されます。
ビルド成果物の.rscファイルによるサイズ計測
静的に生成されるページは、next buildの時点でペイロードがファイルとして書き出されます。VercelのガイドHow to optimize RSC payload sizeは.next配下の*.rscをサイズ順に並べる方法を紹介していますが、Next.js 16.4.4のビルドにはindex.rscのほかにセグメント単位のプリフェッチ用ファイル(index.segments/_tree.segment.rscなど)も並びます。ページ単位で比べるなら、セグメント分を除きます。
find .next/server/app -type f -name '*.rsc' ! -name '*.segment.rsc' -exec wc -c {} \; | sort -nr | head -n 5
動的ページ(force-dynamicなど)はここに出てこないので、curlで取得した応答のバイト数で測ります。
Next.js 16.4.4の実物で読むFlightの行構造
行の書式は「16進ID+タグ+本体」
次は、Server ComponentのトップページからClient ComponentのCounterにinitialとuserを渡したページを、Turbopack(Next.js 16の既定)でビルドして取得したペイロードの一部です。検証は2026年11月3日、macOS・Node.js v26.5.0・npm 11.17.0・Next.js 16.4.4・React 19.3.1で、next build後にnext startを起動して行いました(全体3,161バイト、長い行は省略)。
1:"$Sreact.fragment"
2:"/_next/static/chunks/3qfy96eoyh-ek.js"
3:I[39756,["$2"],"default"]
7:I[98016,["$2","$6"],"default"]
a:"$Sreact.suspense"
12:I[68027,["$2"],"default",1]
5:[["children",{"s":"__PAGE__", … ["$","main",null,{"children":[["$","h1",null,{"children":"Home"}],["$","$L7",null,{"initial":1,"user":{"name":"Sato","email":"[email protected]","isAdmin":true}}], …
0:{"P":null,"c":["",""],"q":"","i":false, … "b":"kY3DhEIG_A0XL_ybRDoqs", …
Reactのクライアント側パーサReactFlightClient.js(v19.3.1)は、コロンまでを16進数のIDとして読み、続く1文字がタグなら種類に応じて処理し、タグが無ければJSONとして読みます。IDは登場順ではありません。モジュール参照のI行や文字列の行が先に流れ、ルートの0番が後ろに来ています。["$","main",null,{...}]の4要素配列は「React要素・タグ名・key・props」の並びで、0番の行にある"b"はビルドIDです。
行タグの一覧
実測したページに出てきたタグは、タグ無しのJSON行、I、そしてストリーミングのページでXとCでした。Eはサーバーで例外が起きたときだけ現れます。
| タグ | 意味 | 実務での見え方 |
|---|---|---|
| (なし) | JSONモデル | ツリー本体・文字列 |
| I | モジュール参照 | 同一クライアント参照は再利用 |
| H | ヒント | 先読みするリソース |
| E | エラー | サーバー側の例外 |
| T | 長いテキスト | バイト長を先に送る |
| R / r | ReadableStream開始 | rはバイトストリーム |
| X / x | AsyncIterable / AsyncIterator開始 | xは自身を返すイテレーター |
| C | ストリーム終了 | R・r・X・xを閉じる |
| N / D / J / W | 時刻原点・デバッグ情報 | 開発ビルドで出る |
このほか、バイト長を先に送るバイナリ行が13種類あります。A(ArrayBuffer)、O・o(Int8Array・Uint8Array)、U(Uint8ClampedArray)、S・s(Int16Array・Uint16Array)、L・l(Int32Array・Uint32Array)、G・g(Float32Array・Float64Array)、M・m(BigInt64Array・BigUint64Array)、V(DataView)です。本番の応答にDやWが混ざっていたらビルド構成の事故で、本番版のReactはW行を受け取ると「Failed to read a RSC payload created by a development version of React on the server while using a production version on the client.」を投げます。サーバーとクライアントでReactのビルドが揃っていない状態なので、依存関係の重複を疑ってください。
$付き値の意味
JSON行の中では、文字列の先頭の$が特別な意味を持ちます。同じファイルのparseModelString()が解釈している主な記法は次のとおりです。
| 記法 | 意味 |
|---|---|
| $L7 | 行7への遅延参照(React.lazy) |
| $@b | 行bをPromiseとして参照 |
| $Sreact.suspense | Symbol.for(‘react.suspense’) |
| $2 / $Q5 | 行2の値 / 行5をMapとして参照 |
| $W / $B / $K / $i | Set / Blob / FormData / Iterator |
| $h / $T | Server Reference / Temporary Reference |
| $D2026-11-03T00:00:00.000Z | Date |
| $n9007199254740993 | BigInt |
| $undefined / $NaN / $Infinity / $-0 | JSONで表せない値 |
| $$foo | 文字列 $foo のエスケープ |
行頭のタグと値の$記法は別の名前空間で、行タグのWは開発用のコンソール出力、値の$WはSetです。
I行のチャンク配列におけるTurbopackとWebpackの違い
I行の並び順は、ReactのReactFlightImportMetadata.jsがID = 0/CHUNKS = 1/NAME = 2と定義しています。先頭がモジュールID、次が読み込むチャンクの配列、最後がエクスポート名です。非同期モジュールのときだけ4要素目に1が付き、実測でも12:I[68027,["$2"],"default",1]がそれでした。
2番目の配列の中身はバンドラで変わります。同じアプリを比べると、Turbopackでは3:I[39756,["$2"],"default"]のようにファイルパスだけが入り、そのパスは2:"/_next/static/chunks/…"という別の行に切り出されて$2で参照されていました。next build --webpackでは6:I[3598,["974","$5"],"default"]となり、チャンクID(974)とファイルパスの組が並びます。解説記事の例と見た目が違っても、バンドラの違いであって壊れているわけではありません。
モデル行の側は同じIDを$L7で参照します。同じClient Componentを何か所で使っても参照は1行にまとめられるため、I行の数は画面上のClient Component境界の数とは一致しません。"use client"の範囲を広げてもI行が増えるとは限りません。境界設計は、Client Componentへ渡すpropsの量とクライアント側へ含まれるJavaScriptの量を併せて確認します。
ストリーミングとSuspense境界がペイロードに現れる形
$L9 の行が後から届く段階配信
1.5秒待つ非同期のServer ComponentをSuspenseで囲んだページでは、ペイロードは次のように流れました(全19行・3,231バイト、抜粋)。
8:"$Sreact.suspense"
6:X
7:[["children",{"s":"__PAGE__", … ["$","$8",null,{"fallback":["$","p",null,{"children":"loading..."}],"children":"$L9"}] …
6:C
9:["$","p",null,{"children":["loaded at ","2026-11-02T17:06:41.163Z"]}]
Suspense境界のchildrenは$L9という参照だけが先に届き、ブラウザはその時点でfallbackを描画します。サーバー側でデータがそろうと、最後の9:の行が流れてきて、その場所だけが差し替わります。loading.tsxやSuspenseで囲んだ範囲が段階的に表示されるのはこの仕組みで、UI設計とSEOの注意点はStreaming UIとは?Suspenseで段階表示する仕組みと実装・SEOの注意点で扱っています。
途中で切れたペイロードの見分け方
ストリームが最後まで届かないと、$Lや$@で参照されたIDの行が現れないまま接続が終わります。Reactのパーサ(ReactFlightClient.js)は、未解決の参照を残したまま接続が閉じると、その参照を「Connection closed.」というエラーにします。curlで取得し、参照されているID(上の例なら9)の行があるか、XやRで始まったID(上の例なら6)にC行があるかを数えると切り分けられます。画面がローディング表示のまま進まない場合は、プロキシやCDNによる応答のバッファリングも疑います。この場合は切れるのではなく、全行がまとめて遅れて届きます。
「Failed to fetch RSC payload」の原因と切り分け
エラーが出る条件と出ない条件
ブラウザのコンソールに出る「Failed to fetch RSC payload for https://…. Falling back to browser navigation.」は、Next.jsのfetch-server-response.ts(v16.4.4)のcatch節が出しています。出るのは、ペイロード取得のfetchが例外になったときと、届いた応答をFlightとして読み取る途中で例外になったときです。どちらの場合も、Next.jsは続けて通常のページ遷移(フルリロード)へ切り替えます。ただし、通信断やサーバー障害が続いていれば表示には失敗します。ページを離れる途中で起きた失敗はログに出しません。
逆に、次の3つではエラーを出さずに黙ってフルリロードに切り替わります。「遷移が妙に遅い」「毎回ページ全体が読み直される」という症状はこちらを疑います。
- 応答のContent-Typeが
text/x-componentでない(HTMLが返ってきた) - ステータスが200番台でない、またはResponse.bodyがnull(本文ストリームがない)
- 応答のビルドID(
x-nextjs-deployment-idヘッダ、無ければペイロードの"b")がブラウザ側のビルドと違う=デプロイ直後に古いタブから遷移した
原因別の確認手順
| 症状・状況 | 考えられる原因 | 確認方法 |
|---|---|---|
| proxy.jsで外部ドメインへ転送 | リダイレクト先でCORSに弾かれる | Networkで3xxの行き先 |
| 開発中にだけ出る | 開発サーバーの再起動・切断 | ターミナルのログ |
| 本番の一部ユーザーだけ | 通信断・タイムアウト・中断 | 失敗リクエストの状態 |
| エラーは無いが毎回フルリロード | HTMLが返っている | 応答のContent-Type |
1行目はNext.jsのソースにも、外部URLへのリダイレクトでCORSが失敗するケースとしてコメントが残っています(vercel/next.js#43605)。ブラウザのfetchはリダイレクトを自動でたどるため、遷移先が別オリジンだとCORSエラーで例外になり、このログが出たあとフルリロードで外部ページが開きます。リンクのhrefを最初から外部URLにしておけば止まります。App Routerのルーターは、別オリジンのURLへの遷移をペイロード取得なしの通常遷移として扱います(navigate-reducer.ts)。
CDNがrscヘッダや _rsc を落とすとき
CDN Cachingガイドは、rscヘッダは必ずサーバーまで転送し、_rscはキャッシュキーに含めるよう求めています。CDNがrscヘッダを落とすと、ルーターがRSC Payloadを待っているところにHTMLが返り、上の「黙ってフルリロード」になります。クエリ文字列をキャッシュキーから外す設定のCDNでは、HTMLとペイロードが同じキーに入ります。その結果、RSCリクエストにキャッシュ済みのHTMLが返ったり、逆にページを開いたのにRSC Payloadが返って1:"$Sreact.fragment"のような生の行が画面に表示されたりします。ガイドは、多くのCDNが追加設定なしではVaryに対応しないため_rscを用意している、と説明しています。キャッシュ全体の設計はNext.jsのキャッシュ|16.4のuse cache・revalidateTagの使い分けとCDNで効かない原因で整理しています。
RSC Payloadを肥大化させない設計判断
Client Componentへ渡すpropsは表示に使う項目だけ
ORMやAPIのレコードをそのままClient Componentのpropsに渡す実装は避けてください。上の実測では、ボタンに名前しか表示していないのに、userとして渡したemailとisAdminがペイロードにそのまま載っていました。ページのソースを開けば誰でも読めます。表示に使う項目だけを抜き出して渡すのが原則です。
childrenスロットへのServer Componentの配置
Client Componentの内側にサーバーで取得した内容を置きたいときは、データをpropsで渡さず、Server Componentをchildrenとして差し込みます。公式ドキュメントのModalの例がこの形です。差し込んだServer Componentは描画済みの要素としてペイロードに入るため、元のレコードは送られません。
RSC Payloadの自前API利用を避ける理由
ペイロードを保存して別の場所で配信する、外部システムに読ませる、といった使い方は勧めません。Flightはバージョン間の互換性が公開仕様として保証されていない内部プロトコルで、上で見たとおりバンドラが変わるだけでもI行の形が変わります。外部から受け取ったペイロードを読み取る経路は、次の脆弱性の攻撃面そのものでもあります。
Flightの読み取り処理の脆弱性と修正版
React側:CVE-2025-55182から2026年10月までの10件
2025年12月3日に公開されたCVE-2025-55182(GHSA-fv66-9v8q-g76r、通称React2Shell)は、Flightのデシリアライズ処理に起因するリモートコード実行で、CVSS基本値は10.0でした。影響はreact-server-dom-webpack/react-server-dom-turbopack/react-server-dom-parcelです。その後もReactのセキュリティアドバイザリには同じ層の修正が続き、2026年11月3日時点で10件あります(公開日はUTC)。
| 公開日 | 内容 | 修正版 |
|---|---|---|
| 2025-12-03 | RCE(CVE-2025-55182) | 19.0.1/19.1.2/19.2.1 |
| 2025-12-11 | ソースコード露出・DoS | 19.0.2/19.1.3/19.2.2 |
| 2025-12-12 | DoS(CVE-2025-67779) | 19.0.3/19.1.4/19.2.3 |
| 2026-01-26 | DoS(CVE-2026-23864) | 19.0.4/19.1.5/19.2.4 |
| 2026-04-08 | DoS(CVE-2026-23869) | 19.0.5/19.1.6/19.2.5 |
| 2026-05-06 | DoS(CVE-2026-23870) | 19.0.6/19.1.7/19.2.6 |
| 2026-07-21 | DoS(CVE-2026-44907) | 19.0.8/19.1.9/19.2.8 |
| 2026-10-14 | RCE・DoS(CVE未採番) | 19.0.9/19.1.10/19.2.9/19.3.1 |
2025年12月11日の2件はCVE-2025-55183とCVE-2025-55184、2026年10月14日の2件はGHSA-xqc2-xf4c-x3h3(未認証のRCE)とGHSA-h3gv-c5rc-p453です。各系列とも最終行の版以上にすれば10件すべてが直ります。
Next.js側の対応版とServer Actionsの経路
Next.jsアプリでnpm ls react-server-dom-webpackを実行しても何も出ません。Next.jsはこれらをnext/dist/compiledに同梱しているため、確認と更新はnextの版で行います。React2Shellに対応するNext.js側のCVE-2025-66478(GHSA-9qr9-h5gf-34mp)の修正版は15.0.5/15.1.9/15.2.6/15.3.6/15.4.8/15.5.7/16.0.7で、13.x・14.x stable・Pages Router・Edge Runtimeは影響を受けません。2026年10月14日の修正(Server ActionsのDoSなど)は16.4.1と15.5.28で入っており、2026年11月3日時点のnpmのlatestは16.4.4(11月2日公開)、15系はbackportタグの15.5.28です。影響版の判定手順と後続CVEの詳細はReact2Shell(CVE-2025-55182)とは?対応手順と影響版の確認・後続CVEまで直る修正版、版ごとの更新手順はNext.js 16の最新バージョンは16.4|リリース履歴・LTS期限・セキュリティ修正版と更新手順を参照してください。
この一連の脆弱性が示しているのは、RSC Payloadは「サーバーが送るもの」であると同時に「サーバーが受け取るもの」でもあるという点です。Server Actionsの引数も同じFlightで直列化され、サーバー側で読み取られます。影響条件は脆弱性ごとに異なります。2026年10月のServer ActionsのDoSは少なくとも1つのServer Actionを使うアプリが対象であり、利用機能と各アドバイザリを照合して対応版へ更新します。社内でアップデートの影響範囲を判断しきれない場合は、脆弱性診断・セキュリティ診断で公開中のアプリを外部から確認する方法もあります。
よくある質問
RSCは何の略で、RSC Payloadはどう読みますか?
RSCはReact Server Componentsの略で、RSC Payloadは「アールエスシー ペイロード」と読みます。日本語ではRSCペイロードとも書きます。RSCという略語はReact以外でも使われるため、検索するときは「rsc react」「rsc next.js」のように語を添えると絞り込めます。
「payload react」で出てくるPayload CMSとRSC Payloadは同じものですか?
別物です。Payload CMSはTypeScript製のヘッドレスCMS(パッケージ名はpayloadや@payloadcms/*)で、RSC PayloadはReactの内部データ形式(実装はreact-server-dom-*)です。ただしPayload CMSの3.x系はNext.jsのApp Routerのプロジェクトに組み込んで使うため、同じプロジェクトの中に両方の語が出てくることがあります。CMSについてはPayload CMSとは?使い方・Next.js統合・Strapiとの違いを解説【v3.90・4.0 beta】を参照してください。
text/x-component とは何のContent-Typeですか?
RSC Payloadの応答に付くContent-Typeです。Next.jsのソースではRSC_CONTENT_TYPE_HEADERという定数で定義され、ルーターはこの値で始まる応答だけをペイロードとして読みます。output: 'export'の静的書き出しでは、ペイロードは.txtファイルとして配信され、text/plainも受け付けます。
next-router-state-tree ヘッダは何のために送られていますか?
ブラウザが今表示しているルートの状態をサーバーへ伝え、変わったセグメントだけのペイロードを返してもらうためのヘッダです。CDN Cachingガイドによると、プリフェッチ以外のリクエストでこのヘッダを省くと、サーバーは差分ではなくページ全体のペイロードを返します。壊れはしませんが、転送量は増えます。
RSC PayloadはApp Routerでしか使えませんか?
Next.jsではApp Routerだけです。Pages Routerは__NEXT_DATA__のJSONでデータを渡す別の仕組みで、Flightを使いません。React2ShellでPages Routerが影響を受けなかったのはこのためです。Next.jsの外では、Viteの@vitejs/plugin-rscやParcel(react-server-dom-parcel)でも同じFlight形式のペイロードが使われます。