curlで取ると中身が空 — SSRとNext.js

SSRとNext.js。サーバーで組み立てたWebページをブラウザに届ける書類と矢印。

※本記事はアフィリエイト広告(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で十分だということ。やりすぎると、増えるのは仕事だけ

この記事でやること

  1. ~/react-demo/ をビルドして配り、curl で取る。 中身が空であることを、目で見る
  2. CSR / SSR / SSG を表で並べ、それぞれ何を速くして、何を遅くするかを整理する
  3. ~/next-demo/ に Next.js の最小構成を作る(~/react-demo/ は消さない。比較対象として残す)
  4. 同じ curl を Next.js 側に打ち、中身が入っていることと、ページごとにタイトルが違うことを確かめる
  5. npm run build の出力で、同じプロジェクトの中に SSG のページと SSR のページが混ざっていることを見る
  6. 配り方が変わることを確認する。 nginx の設定が try_files から proxy_pass に変わる

先に知る言葉

この記事で初めて出てくる言葉です。 基本的な言葉は用語集にもまとめてあります。

言葉意味
レンダリングデータからHTMLを組み立てること。 「描画」と訳されるが、この記事では「HTMLを作る作業」の意味
CSRClient Side Rendering。ブラウザ(クライアント)がHTMLを作る。 いまの ~/react-demo/ がこれ
SSRServer Side Rendering。リクエストが来るたびに、サーバーがHTMLを作って返す
SSGStatic Site Generation。ビルドのときに1回だけHTMLを作っておき、あとはファイルを配るだけ
プリレンダリングブラウザに届く前にHTMLを作っておくことの総称。SSR と SSG は、どちらもこれの一種
ハイドレーションサーバーが作ったHTMLに、ブラウザ側で React を「後から乗せる」作業。 これが終わるまでボタンは押せない
クローラー検索エンジンがページを取りに来るプログラム。 人間ではないので、基本的に curl に近い見え方をする
OGPSNSにURLを貼ったときに出る、タイトル・説明・画像。HTMLの <meta> タグから読まれる
Next.jsReact を SSR / SSG つきで動かすためのフレームワーク。 React の上に乗るもので、別物ではない
サーバーコンポーネントサーバーでだけ実行され、ブラウザには送られないコンポーネント。Next.js の App Router の既定

① まず、いまの作りの何が問題なのかを見る

「SSRとは」から入りません。 先に、困っている状態を作ります。

ビルドして配る

VMの中です。

bash
$ cd ~/react-demo
$ npm run build

dist/ ができます。ビルドツールの回でやったとおり、これが「配るもの」の全部です。

ルーティングの回で作った spa-server.py を使います。消してしまった場合は、~/react-demo/spa-server.py として、もう一度これを作ってください。

bash
$ nano ~/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 と同じことを、目に見える形で書いたものです。

bash
$ sudo ufw allow 8000/tcp
$ python3 ~/react-demo/spa-server.py

別のターミナルで、curl で取る

VS Code のターミナルをもう1枚開いてください(VS Code Remote の回)。

bash
$ curl -s http://localhost:8000/
<!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> だけが返っている画面を撮ってください。

どのページを取っても、同じものが返る

ここが本題です。

bash
$ curl -s http://localhost:8000/tasks/3 | grep -o "<title>[^<]*</title>"
<title>Vite + React</title>
bash
$ curl -s http://localhost:8000/tasks/999 | grep -o "<title>[^<]*</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は、まだ何も押せません。

  1. サーバーが中身入りのHTMLを返す → 文字が見える
  2. ブラウザがJSをダウンロードして実行する
  3. 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 のバージョンを先に見る

bash
$ node -v
v22.11.0

v20.9 より古いと、いまの Next.js は動きません。 古い場合は npm の回に戻って入れ直してください。

作る

bash
$ cd ~
$ npx create-next-app@latest next-demo --ts --app --eslint --no-tailwind --no-src-dir --import-alias "@/*"

フラグを全部書いているのは、対話の質問を出さないためです。何も付けずに打つと、10個くらい聞かれます。 それでも構いませんが、この記事と同じ構成にするには、上のとおり打ってください。

追加で何か聞かれたら、Enter(既定値)で構いません。

フラグ意味
--tsTypeScript を使う
--appApp Router を使う(新しいほうの作り。SSRとSSGの切り替えが素直)
--eslintESLint を入れる
--no-tailwindCSSフレームワークを入れない(今日は関係ないので減らす)
--no-src-dirsrc/ を作らない(階層を1つ減らす)
--import-alias "@/*"import のときの短縮名。既定のまま

数分かかります。

何ができたか

bash
$ ls ~/next-demo
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/ です。

bash
$ ls ~/next-demo/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番にずらします。

bash
$ sudo ufw allow 4000/tcp
$ cd ~/next-demo
$ npm run dev -- -H 0.0.0.0 -p 4000
オプション意味
--(ハイフン2つ)ここから先は npm ではなく next への引数だ、という区切り
-H 0.0.0.0VMの外からの接続も受ける。 これが無いとホストのブラウザから見えません
-p 40004000番で待つ

-H 0.0.0.0 と ufw の2つが要るのは、nginx の回から毎回同じです。ネットワークの回の切り分けがそのまま使えます。

ホストのブラウザで http://192.168.226.50:4000/ を開いて、Next.js の初期画面が出れば成功です。

タスク一覧を書く

app/page.tsx を、まるごと書き換えます。

bash
$ nano ~/next-demo/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 の別物ではありません。 書くものは同じで、「動く場所」だけが違います。

保存すると、ブラウザが勝手に更新されます。

ページごとに違うタイトルを付ける

①で見た「どのページも同じタイトル」を、直します。

bash
$ mkdir -p ~/next-demo/app/tasks/\[id\]
$ nano ~/next-demo/app/tasks/\[id\]/page.tsx

フォルダ名の [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 が Promiseawait で取り出す。 非同期処理の回でやった await そのもの
id: stringやはり文字列です。ルーティングの回の「useParams() は必ず文字列を返す」と同じ落とし穴が、ここにもあります

generateMetadata が、そのページの <title> を作る関数です。①で「全ページ同じ」だった部分です。


⑤ 同じ curl を打つ

これが、この記事の答え合わせです。

別のターミナルで打ってください(Next.js の npm run dev は動かしたまま)。

bash
$ curl -s http://localhost:4000/
<!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の中に入っています。

①と同じ形で、はっきり見ます。

bash
$ curl -s http://localhost:4000/ | grep -c "牛乳を買う"
1

~/react-demo/ 側は 0 です。 比べてみてください(8000番を動かし直す必要があります)。

[スクリーンショット: 02_curl_中身入り.png] curl -s http://localhost:4000/ の結果に <h1>タスク一覧</h1> と <li> が含まれている画面を撮ってください。

タイトルも、ページごとに違う

bash
$ curl -s http://localhost:4000/tasks/3 | grep -o "<title>[^<]*</title>"
<title>タスク 3 — next-demo</title>
bash
$ curl -s http://localhost:4000/tasks/7 | grep -o "<title>[^<]*</title>"
<title>タスク 7 — next-demo</title>

①では、両方とも Vite + React でした。

これが SSR の正体です。 魔法は起きていません。 「ブラウザでやっていた map を、サーバーで先にやって、結果のHTMLを返している」だけです。

JavaScript は、このあとちゃんと送られてきます。 確かめられます。

bash
$ curl -s http://localhost:4000/ | grep -c "_next/static"

0 ではない数が返ります。 ②で書いた「SSRにしてもJSは送られる」の実物です。

ビルドすると、SSG と SSR が分かれて見える

Ctrl + C で npm run dev を止めてから、本番用にビルドします。

bash
$ cd ~/next-demo
$ npm run build

最後に、こういう表が出ます。

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 がリクエストごとに違うからです。

実物も見えます。

bash
$ ls ~/next-demo/.next/server/app/
_not-found  _not-found.html  favicon.ico  index.html  index.rsc  page.js  tasks

index.html があります。 ビルドの時点で、HTMLがファイルとして書き出されているということです。

bash
$ grep -c "牛乳を買う" ~/next-demo/.next/server/app/index.html
1

これが SSG です。 配るときには、もう何も計算しません。

[スクリーンショット: 03_next_build_ルート一覧.png] npm run build の最後に出る Route 一覧(○ と ƒ の記号が付いた表)を撮ってください。

本番モードで動かす

bash
$ npm start -- -H 0.0.0.0 -p 4000

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も無関係
ブログ・ドキュメント・LPSSG誰が見ても同じ。 検索から来てほしい
商品ページ(在庫や価格が動く)SSR検索から来てほしいうえに、中身が頻繁に変わる
ニュース・掲示板SSR同上

判断は、2つの質問だけです。

  1. そのページは、検索やSNSから直接来てほしいか? —— いいえ なら CSR。終わり
  2. そのページの中身は、誰が見ても同じか? —— はい なら 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/ を消してしまった → 比較対象が無くなるだけで、この記事の続きはできます。 ただし①をやり直せません。


後片づけ

開けたポートを閉じます。

bash
$ sudo ufw delete allow 8000/tcp
$ sudo ufw delete allow 4000/tcp
$ sudo ufw status

ビルドの成果物は消して構いません。

bash
$ rm -rf ~/react-demo/dist
$ rm -rf ~/next-demo/.next

node_modules の大きさを、1回だけ見ておいてください。

bash
$ du -sh ~/next-demo/node_modules
412M

数字は違って構いません。 npm の回で書いたとおり、これは消してよいものです。npm install で戻ります。

全部やり直したいときは:

bash
$ rm -rf ~/next-demo

~/react-demo/ は、絶対に消さないでください。 これまで書いてきたコンポーネント・テスト・型が全部入っています。

残しておくファイル構成は、こうなっています。

bash
$ ls ~
next-demo  react-demo  server  vite-demo  web
フォルダ中身
web素のHTML/CSS
vite-demoVite だけ(Vanilla)
react-demoReact + TypeScript の本体。CSR
next-demoNext.js。SSR と SSG
serverNode.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つも無いほうです。

今日やったのは、「直すこと」ではなく、「いま自分がどれを選んでいるかを、言葉にできるようにすること」でした。

参考リンク


次に読む

この記事は 【第4段階】フロントエンド の 14 / 15 本目です。

記事
← 前の記事E2Eはsleepで待たない — Playwrightで1本目
→ 次の記事オフラインでも動かす — PWAとService Worker

上から順に読めば積み上がるように並べています。 飛ばしても構いませんが、詰まったら前の回に戻ってください。

全体の順路は はじめに にあります。

roadmap.sh のどこをやっているか

Frontend›SSR / SSG
  • Server-side rendering
  • Next.js
  • Static Site Generators

この記事は、上の項目を実際に手を動かして確かめる回です。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

コメント

コメントする

目次