※本記事はアフィリエイト広告(PR)を含みます。
ブラウザでは見えるのに、curlで取ると中身が空になる。これは描画をどこでやるかの違いです。Next.jsで場所を変えて確かめます。
前回: E2Eはsleepで待たない — Playwrightで1本目 作業場所はVMの中(Ubuntu)、確認はホストの Windows のブラウザです。ここまで作ってきた
~/react-demo/を、そのまま使います。
まず、いま作っているものを1回だけ疑ってみます。
ブラウザで開けば、タスク一覧はちゃんと表示されます。 リンクも押せます。テストも通っています。型も付きました。動いています。
では、ブラウザ以外から見たらどうなっているのか。
パフォーマンスの回で「推測しないで測る」をやりました。今日も同じです。推測せずに、curl で1回取ってみます。
返ってくるのは、これだけです。
<div id="root"></div>
タスクは1件も入っていません。 タイトルも Vite + React のままです。
そして、ここが問題です。
検索エンジンのクローラーと、SNSのリンクプレビューが見ているのは、この「空のHTML」のほうです。
ルーティングの回の最後に、こう書きました。
これは SPA の避けがたい弱点です。本気で直すには、サーバー側でHTMLを組み立てる仕組み(SSR)が要ります。
今日、それをやります。 ただし——「SSRにすれば解決」ではありません。 そこを先に言っておきます。SSRは、サーバーが常駐する、という代償と引き換えです。
対象レベル: 初級 / 区分: 必修
この記事でわかること
curlで取れるHTMLと、ブラウザで見えている画面は、別物だということ。クローラーもSNSも、前者しか見ない。開発者ツールの「Elements」ではなく「ページのソース」のほうが本物- HTMLを作る場所は3つあること(CSR / SSR / SSG)。それぞれ何が速くて、何が遅いかが違う。「SSRが常に正しい」ではない
- 一番強いのは、たいてい SSG だということ。内容が読者ごとに変わらないページなら、SSRを選ぶ理由はほとんど無い
- SSRにしても、JavaScript は結局ブラウザに送られること。HTMLが先に見えるだけで、押せるようになるのは後(ハイドレーション)
- SSRを選んだ瞬間、「静的ファイルを置くだけ」が終わること。
dist/を nginx に置くやり方は使えなくなり、Node が常駐して、それが落ちたらサイトが落ちる - 管理画面のようにSEOが要らないものは、CSRで十分だということ。やりすぎると、増えるのは仕事だけ
この記事でやること
~/react-demo/をビルドして配り、curlで取る。 中身が空であることを、目で見る- CSR / SSR / SSG を表で並べ、それぞれ何を速くして、何を遅くするかを整理する
~/next-demo/に Next.js の最小構成を作る(~/react-demo/は消さない。比較対象として残す)- 同じ
curlを Next.js 側に打ち、中身が入っていることと、ページごとにタイトルが違うことを確かめる npm run buildの出力で、同じプロジェクトの中に SSG のページと SSR のページが混ざっていることを見る- 配り方が変わることを確認する。 nginx の設定が
try_filesからproxy_passに変わる
先に知る言葉
この記事で初めて出てくる言葉です。 基本的な言葉は用語集にもまとめてあります。
| 言葉 | 意味 |
|---|---|
| レンダリング | データからHTMLを組み立てること。 「描画」と訳されるが、この記事では「HTMLを作る作業」の意味 |
| CSR | Client Side Rendering。ブラウザ(クライアント)がHTMLを作る。 いまの ~/react-demo/ がこれ |
| SSR | Server Side Rendering。リクエストが来るたびに、サーバーがHTMLを作って返す |
| SSG | Static Site Generation。ビルドのときに1回だけHTMLを作っておき、あとはファイルを配るだけ |
| プリレンダリング | ブラウザに届く前にHTMLを作っておくことの総称。SSR と SSG は、どちらもこれの一種 |
| ハイドレーション | サーバーが作ったHTMLに、ブラウザ側で React を「後から乗せる」作業。 これが終わるまでボタンは押せない |
| クローラー | 検索エンジンがページを取りに来るプログラム。 人間ではないので、基本的に curl に近い見え方をする |
| OGP | SNSにURLを貼ったときに出る、タイトル・説明・画像。HTMLの <meta> タグから読まれる |
| Next.js | React を SSR / SSG つきで動かすためのフレームワーク。 React の上に乗るもので、別物ではない |
| サーバーコンポーネント | サーバーでだけ実行され、ブラウザには送られないコンポーネント。Next.js の App Router の既定 |
① まず、いまの作りの何が問題なのかを見る
「SSRとは」から入りません。 先に、困っている状態を作ります。
ビルドして配る
VMの中です。
dist/ ができます。ビルドツールの回でやったとおり、これが「配るもの」の全部です。
ルーティングの回で作った spa-server.py を使います。消してしまった場合は、~/react-demo/spa-server.py として、もう一度これを作ってください。
import http.server
import os
os.chdir(os.path.expanduser("~/react-demo/dist"))
class SPAHandler(http.server.SimpleHTTPRequestHandler):
def translate_path(self, path):
full = super().translate_path(path)
if os.path.exists(full):
return full
return os.path.join(os.getcwd(), "index.html")
server = http.server.HTTPServer(("0.0.0.0", 8000), SPAHandler)
print("http://0.0.0.0:8000/ で待っています")
server.serve_forever()
「存在しないパスなら index.html を返す」だけのサーバーです。nginx の try_files と同じことを、目に見える形で書いたものです。
別のターミナルで、curl で取る
VS Code のターミナルをもう1枚開いてください(VS Code Remote の回)。
<!doctype html>
<html lang="en">
<head>
<meta charset="UTF-8" />
<link rel="icon" type="image/svg+xml" href="/vite.svg" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>Vite + React</title>
<script type="module" crossorigin src="/assets/index-BvT9kQ2x.js"></script>
<link rel="stylesheet" crossorigin href="/assets/index-C7pQzL8m.css">
</head>
<body>
<div id="root"></div>
</body>
</html>
ハッシュの文字列は違って構いません。 見てほしいのは、<body> の中身が <div id="root"></div> の1行しかないことです。
タスクの文字は、1文字も入っていません。
[スクリーンショット: 01_curl_空のhtml.png] curl -s http://localhost:8000/ を実行して、<div id="root"></div> だけが返っている画面を撮ってください。
どのページを取っても、同じものが返る
ここが本題です。
<title>Vite + React</title>
<title>Vite + React</title>
存在しないタスクでも、同じタイトルです。
spa-server.pyは「見つからなければindex.htmlを返す」サーバーです。 つまり、どのURLを叩いても、返ってくるHTMLは1種類しかありません。 これは不具合ではなく、SPAの設計そのものです。
何が困るのか
3つ、具体的に困ります。
| 誰が | 何を見るか | 結果 |
|---|---|---|
| 検索エンジン | 最初に取るのは、この空のHTML | 中身が無いページとして扱われる可能性がある。 タイトルも全ページ同じ |
| SNSのリンクプレビュー | <meta property="og:title"> などをHTMLから読むだけ。JavaScript は実行しない | どのタスクのURLを貼っても、まったく同じプレビューが出る |
| 人間(回線が細い場合) | JSを落とし終わるまで、真っ白 | 表示が始まるのが遅い |
「Google は JavaScript を実行してくれる」という話は、半分だけ本当です。 実行はしますが、それは「後回しの2周目」です。1周目のHTMLに何も無いページは、扱いが不利になります。 そして、SNSのプレビューは実行しません。 X も Slack も Discord も、HTMLを取ってタグを読むだけです。ここは「半分本当」ですらありません。
開発者ツールで、同じことを確かめる
ホストのブラウザで http://192.168.226.50:8000/ を開いてください(IPは自分の値に)。
| 押すキー | 見えるもの | 正体 |
|---|---|---|
Ctrl + U(ページのソースを表示) | <div id="root"></div> だけ | サーバーから届いた、生のHTML |
F12 → Elements | タスクの <li> が並んでいる | JavaScript が動いた後の DOM |
この2つが違うことが、開発者ツールの回で書いた「Elements は HTML ではない」の実物です。
curl が見ているのは、左の列です。
Ctrl + C でサーバーを止めてください。
② 描画の場所は3つある
問題がはっきりしたので、選択肢を並べます。
「HTMLを、いつ、どこで作るか」の違いだけです。それ以外は同じ React です。
| いつHTMLを作るか | 誰が作るか | curl に何が返るか | |
|---|---|---|---|
| CSR | ブラウザに届いてから | ブラウザのJavaScript | 空(<div id="root"> だけ) |
| SSR | リクエストが来るたび | サーバーの Node | 中身入り |
| SSG | ビルドのとき、1回だけ | ビルドを実行した Node | 中身入り |
そして、何が速くて何が遅いかです。
| 最初の表示 | 画面の切り替え | サーバーの負荷 | 内容の新しさ | |
|---|---|---|---|---|
| CSR | 遅い(JSを落として実行するまで空) | 速い(HTMLを取り直さない) | 無い(ファイルを配るだけ) | 常に最新(開いた時点で取りに行く) |
| SSR | 速い(中身入りHTMLが最初に届く) | 速い(一度動き出せばCSRと同じ) | 毎回かかる。アクセスが増えるほど積み上がる | 常に最新 |
| SSG | 一番速い(ファイルを返すだけ) | 速い | 無い | ビルドした時点で固定。変えるには作り直す |
「一番速い」と「一番新しい」は、両立しません。 ここが選択の中心です。
「SSRにすれば速くなる」は間違い
よくある誤解を、先に潰しておきます。
SSRにしても、JavaScript は結局ブラウザに送られます。
サーバーが作るのは「最初の1枚のHTML」だけです。そのHTMLは、まだ何も押せません。
- サーバーが中身入りのHTMLを返す → 文字が見える
- ブラウザがJSをダウンロードして実行する
- React が、すでにあるHTMLに「ここが自分の担当だ」と紐付ける → ここで初めて押せるようになる
3 を「ハイドレーション」と呼びます。 水を与える、という意味です。
つまり、SSRで速くなるのは「見え始めるまで」だけです。「触れるようになるまで」は、CSRとほとんど変わりません。
むしろ、こういう状態が生まれます。 「文字は出ているのに、ボタンを押しても何も起きない数百ミリ秒」。 CSRなら真っ白なので、ユーザーは押そうともしません。 どちらがマシかは、場合によります。
SSR には、CSR に無いコストがある
パフォーマンスの回で TTFB という言葉を出しました。
TTFB = リクエストを出してから、最初の1バイトが返ってくるまで。ここが長い=サーバー側が遅い
CSR のTTFBは、ほぼ最速です。 ファイルをそのまま返しているだけだからです。
SSR は、ここに「HTMLを組み立てる時間」が丸ごと乗ります。 データベースに問い合わせるページなら、その時間もTTFBに入ります。
そして、それが「アクセスの数だけ」起きます。
③ SSG が一番強い場面
では、いつSSRを選ぶのか。 逆から考えるほうが早いです。
「そのページの中身は、誰が見ても同じか?」 同じなら、リクエストのたびに作り直す理由はありません。 1回作って、配るだけでいい。それが SSG です。
| ページ | 誰が見ても同じか | 向いているもの |
|---|---|---|
| ブログの記事 | 同じ | SSG |
| 技術ドキュメント | 同じ | SSG |
| 会社紹介・料金ページ | 同じ | SSG |
| 商品一覧(在庫数を出す) | 違う(時間で変わる) | SSR |
| ログイン後のダッシュボード | 違う(人ごとに変わる) | CSR(後述) |
| 管理画面 | 違う | CSR |
「内容が変わらないページを、リクエストのたびに作り直している」——これが、一番よくある無駄です。
このサイト自身が、その例です
いま読んでいるこのサイトは、WordPress で動いています。
WordPress は、リクエストが来るたびに PHP がデータベースに問い合わせて、HTMLを組み立てて返しています。 仕組みとしては SSR です。
ですが、この記事の内容は、公開したあとほとんど変わりません。
1万人が読んだら、まったく同じHTMLを1万回作り直しているということです。
だから、この手のサイトには必ずキャッシュのプラグインが入ります。 やっていることは「1回作ったHTMLをファイルに保存して、2回目からはそれを返す」——つまり、後付けの SSG です。
Redis の回でやった「結果を取っておいて、2回目から使い回す」と、同じ考え方です。
SSG は、「キャッシュを、後付けではなく最初から設計に入れたもの」だと考えると分かりやすいです。 リクエストが来る前に、全部作り終えている。 キャッシュの究極形です。
そして SSG の弱点も、キャッシュと同じです。
- 内容を直したら、作り直さないと反映されない
- ページ数が増えるほど、ビルドが長くなる(1万記事なら1万枚作る)
- 「ログインしている人だけに出す」ができない(ビルド時には、誰が見るか分からない)
④ Next.js で最小のものを作る
言葉の整理はここまでです。実物を作ります。
~/react-demo/ は消しません。 比較対象として残します。 新しく ~/next-demo/ を作ります。
Node のバージョンを先に見る
v22.11.0
v20.9 より古いと、いまの Next.js は動きません。 古い場合は npm の回に戻って入れ直してください。
作る
フラグを全部書いているのは、対話の質問を出さないためです。何も付けずに打つと、10個くらい聞かれます。 それでも構いませんが、この記事と同じ構成にするには、上のとおり打ってください。
追加で何か聞かれたら、Enter(既定値)で構いません。
| フラグ | 意味 |
|---|---|
--ts | TypeScript を使う |
--app | App Router を使う(新しいほうの作り。SSRとSSGの切り替えが素直) |
--eslint | ESLint を入れる |
--no-tailwind | CSSフレームワークを入れない(今日は関係ないので減らす) |
--no-src-dir | src/ を作らない(階層を1つ減らす) |
--import-alias "@/*" | import のときの短縮名。既定のまま |
数分かかります。
何ができたか
README.md app eslint.config.mjs next-env.d.ts next.config.ts node_modules package.json package-lock.json public tsconfig.json
~/react-demo/ と、驚くほど似ています。 package.json があり、node_modules があり、tsconfig.json があります。
違うのは app/ です。
favicon.ico globals.css layout.tsx page.tsx
app/の中の「フォルダ構成」が、そのままURLになります。app/page.tsx→/、app/tasks/page.tsx→/tasks。 ルーティングの回で<Route path="/tasks/:id">と書いていたものが、フォルダになった、と思ってください。
index.html はどこにも無いことに注意してください。 無いのではなく、layout.tsx から作られます。
動かす
ここで1つ、必ず引っかかる点があります。
Next.js の既定のポートは 3000 です。 そこには、第5段階で作った API サーバーがいます。
ぶつかるので、4000番にずらします。
| オプション | 意味 |
|---|---|
--(ハイフン2つ) | ここから先は npm ではなく next への引数だ、という区切り |
-H 0.0.0.0 | VMの外からの接続も受ける。 これが無いとホストのブラウザから見えません |
-p 4000 | 4000番で待つ |
-H 0.0.0.0 と ufw の2つが要るのは、nginx の回から毎回同じです。ネットワークの回の切り分けがそのまま使えます。
ホストのブラウザで http://192.168.226.50:4000/ を開いて、Next.js の初期画面が出れば成功です。
タスク一覧を書く
app/page.tsx を、まるごと書き換えます。
type Task = { id: number; title: string; done: boolean };
const tasks: Task[] = [
{ id: 1, title: "牛乳を買う", done: false },
{ id: 2, title: "ゴミを出す", done: true },
{ id: 3, title: "請求書を送る", done: false },
];
export default function Home() {
return (
<main>
<h1>タスク一覧</h1>
<ul>
{tasks.map((t) => (
<li key={t.id}>
<a href={`/tasks/${t.id}`}>{t.title}</a>
{t.done ? " (完了)" : ""}
</li>
))}
</ul>
</main>
);
}
見てください。 コンポーネントの回で書いたものと、1文字も変わりません。 map して key を付けて返すだけです。
これが一番大事な点です。 Next.js は React の別物ではありません。 書くものは同じで、「動く場所」だけが違います。
保存すると、ブラウザが勝手に更新されます。
ページごとに違うタイトルを付ける
①で見た「どのページも同じタイトル」を、直します。
フォルダ名の
[id]の角カッコは、シェルでは特別な意味を持ちます。 上のように\でエスケープするか、フォルダ名をクォートで囲んでください。
type Props = { params: Promise<{ id: string }> };
export async function generateMetadata({ params }: Props) {
const { id } = await params;
return { title: `タスク ${id} — next-demo` };
}
export default async function TaskDetail({ params }: Props) {
const { id } = await params;
return (
<main>
<h1>タスク {id}</h1>
<p>この見出しは、サーバーで組み立てられています。</p>
<a href="/">一覧へ戻る</a>
</main>
);
}
3つ、確認してください。
| 書いたもの | 何をしているか |
|---|---|
app/tasks/[id]/ | フォルダ名の [id] が、パスパラメータ。useParams() の代わり |
params が Promise | await で取り出す。 非同期処理の回でやった await そのもの |
id: string | やはり文字列です。ルーティングの回の「useParams() は必ず文字列を返す」と同じ落とし穴が、ここにもあります |
generateMetadata が、そのページの <title> を作る関数です。①で「全ページ同じ」だった部分です。
⑤ 同じ curl を打つ
これが、この記事の答え合わせです。
別のターミナルで打ってください(Next.js の npm run dev は動かしたまま)。
<!DOCTYPE html><html lang="en"><head><meta charSet="utf-8"/><title>Create Next App</title>
...
<main><h1>タスク一覧</h1><ul><li><a href="/tasks/1">牛乳を買う</a></li><li><a href="/tasks/2">ゴミを出す</a> (完了)</li><li><a href="/tasks/3">請求書を送る</a></li></ul></main>
...
タスクの文字が、HTMLの中に入っています。
①と同じ形で、はっきり見ます。
1
~/react-demo/ 側は 0 です。 比べてみてください(8000番を動かし直す必要があります)。
[スクリーンショット: 02_curl_中身入り.png] curl -s http://localhost:4000/ の結果に <h1>タスク一覧</h1> と <li> が含まれている画面を撮ってください。
タイトルも、ページごとに違う
<title>タスク 3 — next-demo</title>
<title>タスク 7 — next-demo</title>
①では、両方とも Vite + React でした。
これが SSR の正体です。 魔法は起きていません。 「ブラウザでやっていた
mapを、サーバーで先にやって、結果のHTMLを返している」だけです。
JavaScript は、このあとちゃんと送られてきます。 確かめられます。
0 ではない数が返ります。 ②で書いた「SSRにしてもJSは送られる」の実物です。
ビルドすると、SSG と SSR が分かれて見える
Ctrl + C で npm run dev を止めてから、本番用にビルドします。
最後に、こういう表が出ます。
Route (app) Size First Load JS
┌ ○ / ...
└ ƒ /tasks/[id] ...
○ (Static) prerendered as static content
ƒ (Dynamic) server-rendered on demand
この2つの記号が、②の表そのものです。
| 記号 | 意味 | ②の表でいうと |
|---|---|---|
○ (Static) | ビルド時にHTMLを作り終えた | SSG |
ƒ (Dynamic) | リクエストのたびに作る | SSR |
同じプロジェクトの中に、両方が混ざっています。
/ が ○ になっているのは、tasks の配列がコードに直接書いてあり、リクエストによって変わりようがないからです。Next.js が自分で判断して、SSG にしました。
/tasks/[id] が ƒ なのは、id がリクエストごとに違うからです。
実物も見えます。
_not-found _not-found.html favicon.ico index.html index.rsc page.js tasks
index.html があります。 ビルドの時点で、HTMLがファイルとして書き出されているということです。
1
これが SSG です。 配るときには、もう何も計算しません。
[スクリーンショット: 03_next_build_ルート一覧.png] npm run build の最後に出る Route 一覧(○ と ƒ の記号が付いた表)を撮ってください。
本番モードで動かす
npm run dev ではなく npm start です。npm run build を先にしていないと動きません。
パフォーマンスの回で書いた「開発サーバーで測った数字は当てにならない」は、ここでも同じです。測るなら、必ずこちらです。
⑥ サーバーが要るようになる、という代償
ここからが、この記事で一番言いたいところです。
npm start を Ctrl + C で止めてください。 そして、ブラウザを更新してみてください。
サイトが落ちます。
①の ~/react-demo/ では、こうはなりませんでした。 第6段階でやったとおり、dist/ を nginx の下に置けば、あとは nginx が生きている限り配り続けます。
この違いが、SSR を選ぶときに払う代金です。
| Vite + React(CSR) | Next.js(SSR あり) | |
|---|---|---|
| 配るもの | dist/ — HTML・JS・CSSのファイル | .next/ + node_modules + package.json |
| 置き方 | nginx の root に置くだけ | npm start で Node を常駐させる |
| nginx の役割 | ファイルを配る(try_files) | 後ろの Node に渡す(proxy_pass) |
| プロセスが落ちたら | 関係ない(そもそも無い) | 502 Bad Gateway。サイトが落ちる |
| サーバー再起動後 | 勝手に復活(nginx が enable されていれば) | 自分で起動を仕込まないと復活しない |
| 監視 | ほぼ不要 | 必要(監視の回) |
| 費用 | 静的配信は安い | 常時動くサーバーの代金(コストの回) |
nginx の設定が、まるごと変わる
CSR のとき(ルーティングの回で書いたもの):
server {
listen 80;
server_name app.local;
location / {
root /var/www/react-demo;
try_files $uri $uri/ /index.html;
}
}
SSR のとき:
server {
listen 80;
server_name next.local;
location / {
proxy_pass http://127.0.0.1:4000;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}
下の形は、初めてではありません。 リバースプロキシの回で、API サーバーに対して書いたものと同じです。
つまり、SSR にするというのは、 「フロントエンドが、バックエンドと同じ種類の運用対象になる」ということです。 常駐して、落ちて、再起動が要って、監視が要る。 プロセスとサービスの回でやった
systemdの話が、フロント側にも必要になります。
今日は nginx の設定は入れません。 「入れるとこうなる」を見ておくだけで十分です。
SSG だけなら、静的に戻せる
ただし、逃げ道はあります。
SSR を使わず SSG だけで済むなら、Next.js でも「配るだけ」に戻せます。
// next.config.ts
const nextConfig = {
output: "export",
};
export default nextConfig;
これを入れて npm run build すると、out/ に静的なHTMLが並びます。 dist/ と同じように、nginx に置くだけで動きます。
その代わり、ƒ(Dynamic)のページは使えなくなります。 /tasks/[id] は、generateStaticParams で「どのidを作るか」を先に書かないとビルドが通りません。
この選択が、③の表そのものです。 「誰が見ても同じページ」だけで作れるなら、サーバーは要りません。
SSR を本番で動かすなら、Node.js を動かし続けるサーバーが 1 台要ることになります。手元の VM の外で同じことを試すなら、シンVPS
のように 1GB(1 コア・30GB)が 1 ヶ月契約 750 円、36 ヶ月契約なら月額換算 451 円(税込・2026 年 9 月 1 日改定後、2026-11 時点)で借りられる VPS を学習用に 1 台持つ方法があります。無料のお試し期間は無く、最低利用期間は 3 ヶ月なので、短期で試すというより置いておく前提で選びます。
⑦ やりすぎない
ここまで読むと、「全部 SSR にすればいいのでは」と思えてきます。違います。
SEO が要らないページに SSR を入れるのは、代金だけ払って何も買っていない状態です。
| 作るもの | 選ぶもの | 理由 |
|---|---|---|
| 管理画面 | CSR で十分 | ログインしないと入れない。 検索エンジンにはそもそも見せたくない |
| 社内ツール | CSR で十分 | 同上。初回表示が0.5秒遅くても、誰も困らない |
| ログイン後のダッシュボード | CSR で十分 | 人ごとに中身が違うので、SSGにできない。SEOも無関係 |
| ブログ・ドキュメント・LP | SSG | 誰が見ても同じ。 検索から来てほしい |
| 商品ページ(在庫や価格が動く) | SSR | 検索から来てほしいうえに、中身が頻繁に変わる |
| ニュース・掲示板 | SSR | 同上 |
判断は、2つの質問だけです。
- そのページは、検索やSNSから直接来てほしいか? —— いいえ なら CSR。終わり
- そのページの中身は、誰が見ても同じか? —— はい なら SSG。いいえ なら SSR
SSR にすると、増える仕事
代金の内訳を、具体的に並べます。
windowとdocumentが使えない場所ができる。 サーバーには DOM がありません。 DOM操作の回で書いたコードを、そのままサーバーで動かすと落ちます- サーバーとブラウザで、同じ結果にならないといけない。
new Date()やMath.random()を画面に直接書くと、必ず「ハイドレーションが合わない」エラーが出ます - ライブラリが対応していないことがある。
localStorageを前提にしたものは、サーバーでは動きません - キャッシュの設計が要る。 システム設計の回の話が、そのまま降ってきます
- デプロイが「ファイルを置く」で終わらなくなる
このどれもが、フレームワーク選びの回で書いた「入れると増える仕事」の続きです。
やらなくていい理由があるうちは、やらないほうが強い。 これは手抜きではなく、パフォーマンスの回で書いた「測って許容範囲なら直さない」と同じ判断です。
つまずいたところ
Error: listen EADDRINUSE: address already in use :::3000 → 3000番は、第5段階で作った API が使っています。 -p 4000 を付けてください。動いているものを探すなら ss -tlnp | grep 3000 です(ネットワークの回)。
ホストのブラウザから 4000番に繋がらない → -H 0.0.0.0 の付け忘れか、sudo ufw allow 4000/tcp の忘れです。curl http://localhost:4000/ がVMの中で通るなら、原因は後者です。
npm run dev -- -H 0.0.0.0 -p 4000 の -- を忘れて、効かない → -- が無いと、-H を npm 自身への引数だと解釈されます。 ハイフン2つは必須です。
ReferenceError: window is not defined → サーバーで動いているコードから window を触っています。 サーバーに DOM はありません。 ファイルの先頭に "use client"; を書くか、useEffect の中に移してください。
You're importing a component that needs useState. This React hook only works in a client component. → App Router では、既定で全部サーバーコンポーネントです。useState や onClick を使うファイルの先頭に "use client"; の1行を書いてください。
Hydration failed because the server rendered HTML didn't match the client → サーバーが作ったHTMLと、ブラウザが作ったHTMLが違います。 原因の第1位は new Date() と Math.random() です。作った瞬間が違うので、一致しません。②で書いたハイドレーションが、まさに失敗した状態です。
npx create-next-app が、いろいろ質問してくる → フラグを付けていません。 ④のとおり打つか、質問に答えても構いません(この記事と構成が変わるだけです)。
app/tasks/[id] を作ったつもりが、できていない → シェルが [id] を「iかd1文字」のパターンとして解釈しました。 bash では app/tasks/i や app/tasks/d が既にあるとそちらに置き換わり、zsh では一致するものが無いと no matches found で止まります。 mkdir -p "app/tasks/[id]" のようにクォートで囲んでください。
npm start が Could not find a production build と言う → npm run build を先にしていません。 npm run dev と npm start は別物です。
curl を打ったのに、まだ中身が空 → 8000番(~/react-demo/)を叩いています。 Next.js は 4000番です。
next: not found → cd ~/next-demo を忘れています。 npm の回で書いたとおり、npm run はそのフォルダの package.json を見ます。
npm run build が「メモリが足りない」で落ちる → VMのメモリが 2GB だと起きます。 VMware の設定で 4GB に増やしてください(VMは一度シャットダウンが必要)。
~/react-demo/ を消してしまった → 比較対象が無くなるだけで、この記事の続きはできます。 ただし①をやり直せません。
後片づけ
開けたポートを閉じます。
ビルドの成果物は消して構いません。
node_modules の大きさを、1回だけ見ておいてください。
412M
数字は違って構いません。 npm の回で書いたとおり、これは消してよいものです。npm install で戻ります。
全部やり直したいときは:
~/react-demo/ は、絶対に消さないでください。 これまで書いてきたコンポーネント・テスト・型が全部入っています。
残しておくファイル構成は、こうなっています。
next-demo react-demo server vite-demo web
| フォルダ | 中身 |
|---|---|
web | 素のHTML/CSS |
vite-demo | Vite だけ(Vanilla) |
react-demo | React + TypeScript の本体。CSR |
next-demo | Next.js。SSR と SSG |
server | Node.js の API |
まとめ
curlが返すHTMLと、ブラウザに見えている画面は別物。 CSR のアプリをcurlで取ると<div id="root"></div>しか無い- 開発者ツールの Elements は、JSが動いた後の DOM。 生のHTMLは
Ctrl + U(ページのソース)のほう。クローラーが見るのは後者 - SNSのリンクプレビューは、JavaScript を実行しない。
<meta>タグを読むだけ。 だから CSR だと全ページ同じプレビューになる - SPAでは、どのURLを叩いても同じ
index.htmlが返る。 不具合ではなく、設計そのもの - HTMLを作る場所は3つ。 CSR(ブラウザ)/ SSR(リクエストのたびにサーバー)/ SSG(ビルドのとき1回)
- CSR は最初の表示が遅く、SSR は速い。 ただしサーバーの負荷が毎回かかり、TTFB が伸びる
- SSG は一番速いが、内容がビルド時点で固定される
- SSR にしても JavaScript は送られる。 速くなるのは「見え始めるまで」だけで、「押せるようになるまで」は変わらない
- サーバーのHTMLに React を後から乗せるのがハイドレーション。
new Date()を画面に直接書くと必ず失敗する - 判断は2問だけ。 ①検索から来てほしいか(いいえ→CSR)②誰が見ても同じか(はい→SSG/いいえ→SSR)
- 「内容が変わらないページを毎回作り直す」が、一番よくある無駄。 WordPress のキャッシュプラグインは、後付けの SSG
- SSG は、キャッシュを最初から設計に入れたもの。 弱点もキャッシュと同じで、直したら作り直しが要る
- Next.js は React の別物ではない。 書く JSX は同じ。 違うのは動く場所だけ
- App Router では、フォルダ構成がそのままURLになる。
app/tasks/[id]/page.tsx→/tasks/3 paramsのidは、Next.js でも文字列。useParams()と同じ落とし穴があるnpm run buildの○とƒが、SSG と SSR の実物。 同じプロジェクトに混ざっていて構わない- SSR を選ぶと、「静的ファイルを置くだけ」が終わる。 Node が常駐し、落ちれば 502 になる
- nginx の設定が
try_filesからproxy_passに変わる。 API サーバーに書いたものと同じ形。フロントが、バックと同じ運用対象になる - SSG だけで済むなら
output: "export"で静的に戻せる。 サーバーを持たなくていい - 管理画面・社内ツール・ログイン後の画面は、CSR で十分。 SEO が要らないところに SSR を入れるのは、代金だけ払っている状態
- サーバーには
windowもdocumentも無い。"use client";が、その境界線
①で見た「空のHTML」は、~/react-demo/ の欠陥ではありません。 CSR という選び方の、当然の帰結です。
そして、~/react-demo/ が作ろうとしていたものは、ログインして自分のタスクを管理する画面でした。 ⑦の表でいえば、SSRを入れる理由が1つも無いほうです。
今日やったのは、「直すこと」ではなく、「いま自分がどれを選んでいるかを、言葉にできるようにすること」でした。
参考リンク
- roadmap.sh — React
- roadmap.sh — Frontend
- Next.js 公式ドキュメント
- Next.js — インストール
- Next.js — create-next-app のオプション
- Next.js — 静的エクスポート
- Next.js — ハイドレーションのエラー
- React 公式 — サーバーコンポーネント
- web.dev — Rendering on the web
- MDN — SSR(用語集)
- nginx — try_files
- Vite — 静的サイトのデプロイ
次に読む
この記事は 【第4段階】フロントエンド の 14 / 15 本目です。
上から順に読めば積み上がるように並べています。 飛ばしても構いませんが、詰まったら前の回に戻ってください。
全体の順路は はじめに にあります。
roadmap.sh のどこをやっているか
- Server-side rendering
- Next.js
- Static Site Generators
この記事は、上の項目を実際に手を動かして確かめる回です。

コメント