
React Server Components (RSC)は、Reactアプリケーション開発のメンタルモデルを根本的に変え、レンダリングとデータフェッチの大部分をサーバーに移行させます。このパラダイムでは、新しい通信プロトコルであるReact Flightが導入され、サーバーがUIの更新をクライアントにどのように送信するかが規定されます。このプロトコル、そのシリアライゼーションメカニズム、およびその後の選択的ハイドレーションプロセスを理解することは、RSCベースのアプリケーションを最適化するために不可欠です。
Diagnose Error #418, #423, #425 & get copy-paste code diffs
Paste Next.js or React hydration error logs to instantly diagnose server-client HTML mismatches (dates, localStorage, extension injection) and generate safe fixes.
React Flightプロトコルは、React要素ツリーを効率的に転送するために設計された、カスタムのストリーミングJSONライクなフォーマットです。静的なドキュメントである従来のHTMLとは異なり、Flightは動的な命令ベースのストリームです。これは生のHTMLではなく、React要素のシリアライズされた表現であり、その型、プロップ、子要素、およびクライアントがUIを再構築するための命令が含まれます。
核となる原則は、サーバーがコンポーネントをレンダリングし、「チャンク」のストリームをクライアントに送信することです。各チャンクには、新しいUI要素、既存の要素への更新、またはクライアントサイドコードをロードするための命令が含まれます。このストリーミングの性質は、コンポーネントツリー全体が解決される前にクライアントがUIの一部をレンダリングを開始できるため、体感パフォーマンスにとって非常に重要です。
Flightワイヤーフォーマットは、JSON配列のシーケンスであり、それぞれが特定の命令またはデータペイロードを表します。各配列の最初の要素は、命令のタイプを示す数値タグです。
単純なRSCを考えてみましょう。
// app/page.tsx (Server Component)
import ClientComponent from './ClientComponent';
export default function Page() {
const data = fetchData(); // Server-side data fetching
return (
<div>
<h1>Welcome to RSC</h1>
<p>{data}</p>
<ClientComponent />
</div>
);
}
// app/ClientComponent.tsx (Client Component)
'use client';
import { useState } from 'react';
export default function ClientComponent() {
const [count, setCount] = useState(0);
return (
<button onClick={() => setCount(count + 1)}>
Client Count: {count}
</button>
);
}
Pageがサーバーでレンダリングされると、Flightプロトコルは次のようなストリームを出力する可能性があります(明確にするために簡略化されています)。
0:["$","div",null,{"children":[["$","h1",null,{"children":"Welcome to RSC"}],["$","p",null,{"children":"Server Data"}],["$","@1",null,{}]]}]
1:I{"id":"./app/ClientComponent.tsx","chunks":["app_ClientComponent_tsx"],"name":"default"}
一般的な命令タイプを分解してみましょう。
0: [type, key, ref, props]
type: 文字列("div"、"p"のような組み込み要素の場合)またはクライアントコンポーネントモジュールへの参照(例:"$@1")です。key: React keyプロップ。ref: React refプロップ。props: 要素のプロップを含むオブジェクト。1: I{id, chunks, name}
id: モジュール識別子(例:クライアントコンポーネントファイルへのパス)。chunks: このモジュールをロードするためのチャンク名の配列。name: モジュールからエクスポートされた名前(例:"default")。2: [id, props]
idは以前にインポートされたモジュールを参照します。3: [id, value]
4: [id, error]
5: [id, promise_id]
promise_idを含む別のチャンクを待ちます。クライアントサイドのReactランタイムはこのストリームを解析し、仮想DOMを再構築してレンダリングします。I命令が検出されると、クライアントサイドのバンドラー(例:Webpack、Turbopack)は、クライアントコンポーネントに対応するJavaScriptチャンクをロードするように指示されます。
すべてのJavaScript型がワイヤー経由で直接シリアライズできるわけではありません。関数、イベントハンドラー、およびプレーンなデータ構造ではない複雑なオブジェクトは、サーバーコンポーネントからクライアントコンポーネントに直接渡すことはできません。
サーバーコンポーネントからクライアントコンポーネントへのプロップ: シリアライズ可能なデータ(プリミティブ、プレーンオブジェクト、配列)のみを渡すことができます。関数、JSX要素、またはクラスインスタンスはシリアライズできません。
// ServerComponent.tsx
import ClientComponent from './ClientComponent';
export default function ServerComponent() {
const serverData = { message: 'Hello from server' };
// This is fine: serverData is serializable
return <ClientComponent data={serverData} />;
}
// ClientComponent.tsx
'use client';
export default function ClientComponent({ data }) {
// data.message will be 'Hello from server'
return <p>{data.message}</p>;
}
クライアントコンポーネントからサーバーコンポーネントへのプロップ(children経由): これは一般的なパターンです。サーバーコンポーネントはクライアントコンポーネントをレンダリングし、サーバーコンポーネントを子として渡すことができます。サーバーコンポーネントの子はサーバーでレンダリングされ、そのシリアライズされた出力がクライアントコンポーネントに渡されます。
// ServerComponent.tsx
import ClientWrapper from './ClientWrapper';
export default function ServerComponent() {
// Server-rendered content passed as children to a Client Component
return (
<ClientWrapper>
<h2>This is a Server Component child</h2>
<p>It was rendered on the server.</p>
</ClientWrapper>
);
}
// ClientWrapper.tsx
'use client';
import { useState } from 'react';
export default function ClientWrapper({ children }) {
const [count, setCount] = useState(0);
return (
<div>
<button onClick={() => setCount(count + 1)}>Click me: {count}</button>
{children} {/* Server-rendered content */}
</div>
);
}
このシナリオでは、childrenは関数やJSXオブジェクトとしてシリアライズされません。代わりに、<h2>と<p>要素はサーバーでFlightワイヤーフォーマット表現にレンダリングされ、そのシリアライズされた表現がClientWrapperに渡されます。クライアントサイドのReactランタイムは、ClientWrapperのプロップの一部として、このシリアライズされたchildrenを処理します。
クライアントコンポーネントとサーバーコンポーネントの区別は、ビルドステップで強制されます。バンドラー(Next.jsのWebpackやTurbopackなど)は、'use client'ディレクティブを分析します。
このパーティショニングは、クライアントサイドのバンドルサイズを削減し、機密性の高いロジックや資格情報をクライアントに公開することなくサーバーサイドのデータフェッチを可能にするために重要です。
RSCは、ストリーミングのためにReactのSuspenseメカニズムを活用しています。サーバーコンポーネントが非同期操作(例:データフェッチ)を実行し、まだ解決されていない場合、Reactはそのツリーの一部をレンダリングを中断できます。
すべてのデータが解決されるのを待つ代わりに、サーバーは、解決済みのUI部分と、中断されたコンテンツのプレースホルダー(<template>タグや<div>属性を持つdata-rsc-idなど)を含む初期のHTML「シェル」を送信できます。
<!-- Initial HTML Shell -->
<!DOCTYPE html>
<html>
<head>...</head>
<body>
<div id="__next">
<h1>Welcome to RSC</h1>
<!-- Placeholder for suspended content -->
<div id="rsc-123"></div>
</div>
<script src="/_next/static/chunks/main.js"></script>
</body>
</html>
中断されたデータがサーバーで解決されると、Reactは追加のFlightプロトコルチャンクを送信します。これらのチャンクには、中断された部分の実際のUIが含まれており、クライアントサイドのReactランタイムはこれを使用してプレースホルダーを置き換えます。これにより、Time To First Byte (TTFB) と First Contentful Paint (FCP) が高速化されます。
// Later Flight chunk resolving rsc-123
3:["rsc-123",["$","p",null,{"children":"Resolved Server Data"}]]
このメカニズムは、ReactDOMServer.renderToReadableStream(Node.js環境の場合)またはrenderToPipeableStreamによって提供されます。これらのAPIは、最初にHTMLシェルを出力し、次にFlightプロトコルチャンクを含むスクリプトタグを出力し続けるストリームを返します。
ハイドレーションとは、クライアントサイドのReactがサーバーでレンダリングされたHTMLを引き継ぎ、イベントリスナーをアタッチしてUIをインタラクティブにするプロセスです。従来のReactでは、アプリケーションツリー全体が一度にハイドレートされていました。大規模で重要でないコンポーネントのハイドレーションが遅い場合、ページ全体のインタラクティブ性がブロックされていました。
React 18で導入された選択的ハイドレーションは、ハイドレーションに優先順位を付けることでこの問題に対処します。クライアントサイドのReactランタイムが起動しても、すぐにすべてをハイドレートするわけではありません。代わりに、ユーザーのインタラクションを監視します。
<Suspense>境界またはまだロード中のコンポーネントに遭遇すると一時停止できます。この優先順位付けは、Reactがツリーのどの部分が「ブロックされている」(例:チャンクのロードを待っている、プロミスの解決を待っている)か、どの部分が「インタラクティブ」であるかを内部的に追跡することで実現されます。イベントが発生すると、Reactはイベントターゲットとそれを処理する必要があるコンポーネントの最も低い共通祖先を決定し、そのパスのハイドレーションを優先します。
| 機能 | 従来のSSR (例: Next.js Pages) | React Server Components (RSC) |
|---|---|---|
| データフェッチ | クライアントでのgetServerSideProps、getStaticProps、useEffect | サーバーコンポーネントでの直接のasync/await |
| バンドルサイズ | クライアントバンドルにはすべてのコンポーネントコードが含まれる | クライアントバンドルにはクライアントコンポーネントのみが含まれる |
| ハイドレーション | 全か無か (React 17)、選択的 (React 18) | ストリーミングによって強化された選択的ハイドレーション |
| ネットワークペイロード | HTML + JSONデータ (props用) | HTMLシェル + Flightプロトコルストリーム |
| インタラクティブ性 | 完全なハイドレーション後 | プログレッシブ、ユーザーインタラクションによって優先順位付け |
| 複雑性 | 明確なクライアント/サーバー分離 | クライアント/サーバーの融合モデル、新しいメンタルモデル |
| キャッシング | HTMLキャッシング、CDN | HTMLキャッシング、RSCペイロードキャッシング (実験的) |
RSCでの「Functions are not valid as a React child」/「Objects are not valid as a React child」エラー:
childrenとしてクライアントコンポーネントに渡します。// ❌ Bad: Passing a function from Server to Client
// ServerComponent.tsx
function handleClick() { console.log('clicked'); }
<ClientButton onClick={handleClick} />
// ✅ Good: Function defined in Client Component
// ClientButton.tsx
'use client';
export default function ClientButton() {
function handleClick() { console.log('clicked'); }
return <button onClick={handleClick}>Click</button>;
}
クライアントコンポーネントのコードが誤ってサーバーで実行される:
'use client'ディレクティブを忘れている。バンドラーはそれをサーバーコンポーネントとして扱い、クライアント専用API(例:window、useState)を使用している場合にエラーが発生します。'use client'を含めます。推移的な依存関係による大規模なクライアントコンポーネントバンドル:
import()とReact.lazyを使用して動的インポートを行い、遅延ロードします。// ClientComponent.tsx
'use client';
import { SomeHeavyUtility } from 'heavy-library'; // This pulls heavy-library into client bundle
// Consider if SomeHeavyUtility can be used in a Server Component
// or if this Client Component can be dynamically imported.
ストリーミングにもかかわらず初期ページロードが遅い:
<Suspense>境界でラップしてコンポーネントツリーのより深い位置に移動し、初期シェルをブロックしないようにします。loading.tsxを使用して、即座のフォールバックUIを提供します。ハイドレーション中のHTMLの不一致:
Warning: Prop 'className' did not match.)が発生する。これは、動的なコンテンツや、誤ってサーバーで実行されるクライアント専用ロジックでよく発生します。windowアクセス、localStorage)がtypeof window !== 'undefined'で保護されているか、useEffectフック内に配置されていることを確認します。Math.random()やDate.now()を直接使用することは避けてください。suppressHydrationWarning(最終手段として)または動的インポートを持つコンポーネントでラップすると役立つことがあります。開発チームは、React Server Componentsを使用してトラフィックの多いeコマースサイトを構築しています。初期ページロードは高速ですが、サーバーによって最初にレンダリングされたコンポーネントでのクライアントサイドの状態更新を伴うその後のインタラクションが遅く感じられると観察しています。React Flightプロトコルとselective hydrationを考慮すると、このパフォーマンスボトルネックの最も可能性の高い原因は次のうちどれですか?
useStateやuseEffectを使用できますか?いいえ。サーバーコンポーネントはステートレスであり、useState、useEffect、useRef、useContextのようなReactフックにアクセスできません。これらのフックは、ブラウザで状態と副作用を管理するためのクライアントサイドの構成要素です。これらを使用するコンポーネントはすべて'use client'でマークする必要があります。
データは、シリアライズ可能(プリミティブ、プレーンオブジェクト、配列)である限り、プロップを介してサーバーコンポーネントからクライアントコンポーネントに渡すことができます。クライアントコンポーネントからサーバーコンポーネントにデータを渡すには、通常、サーバーアクションまたはAPIルートを使用する必要があります。サーバーアクションを使用すると、クライアントコンポーネントからサーバーサイド関数を直接呼び出すことができます。
windowを使用するもの)をインポートするとどうなりますか?サーバーコンポーネントが、適切な保護なしにブラウザ固有のAPI(windowやdocumentなど)に依存するライブラリをインポートすると、サーバーサイドのランタイムエラーが発生します。バンドラーは、クライアントコンポーネントの一部でない限り、このコードをサーバービルドから自動的に除外しません。そのようなインポートは、'use client'とマークされたファイル内でのみ行われるか、Next.jsのnext/dynamicを使用している場合はssr: falseで動的にインポートされるようにする必要があります。
サーバーコンポーネントのレンダリング中にサーバーでエラーが発生した場合、ReactはFlightストリームでエラー命令(4: [id, error])を送信できます。これにより、クライアントはUIの affected 部分にエラーバウンダリのフォールバックを表示でき、アプリケーション全体がクラッシュするのを防ぎます。これは、<Suspense>境界がプロミスをキャッチする方法と似ています。
いいえ、React FlightプロトコルはReact Server Componentsのコア部分であり、Next.jsに固有のものではありません。Next.jsは早期採用者であり、RSCを実装するための堅牢なフレームワークを提供しています。他のフレームワークやカスタムセットアップでも、理論的にはFlightプロトコルを実装してRSCを活用できますが、Next.jsはそれを実用的にするための統合ツール(バンドル、ルーティング、データフェッチ)を提供しています。
AI CLIログの整形、Cron式の作成、JWTの解析、chmod権限の計算をオフラインで実行。

React 19 Actionsの実践的な使用法を解説する包括的なガイド。useActionState, useOptimistic, Server Actionの回復性を本番環境レベルのアーキテクチャとコード例で紹介します。
続きを読む
Next.js15のキャッシュコンポーネントとServer Actionsを網羅した、本番環境レベルのアーキテクチャとコード例を含む完全ガイドです。
続きを読む
Next.js14でServer Actions、useFormState、useFormStatus、Zodを使ったフォーム管理を詳しく解説し、クライアントサイドJavaScriptの負担なく、モダンでプログレッシブエンハンスメントなフォームを構築する方法を学びましょう。
続きを読む