SSRとSSGのフレームワーク — SNSに貼るとタイトルが出ない

SSRとSSGの仕組み。HTMLの書類とブラウザ、サーバーと時計。

※本記事はアフィリエイト広告(PR)を含みます。

SNSに貼るとタイトルが出ないのは、HTMLが空で返っているからです。SSRとSSGが何を肩代わりしているのかを確かめます。

前回: Reactのルーティング — リロードで最初の画面に戻る

これは【深掘り】の記事です。本線の順路ではありません。 本線の curlで取ると中身が空 — SSRとNext.js を読んで「Next.jsを入れると解決するらしい」ところまで分かった人が、「では、Next.jsは私の代わりに何をやっているのか」を自分の手で確かめるための記事です。飛ばしても本線は進みます。

この記事のコマンドは、VMの中(Ubuntu Server)で打ちます。 Windows の PowerShell ではありません。 画面とコンソールの確認は、ホストのWindowsのブラウザで行います。 これまでに作った ~/react-demo/ や ~/reactlab/ には触りません。 この記事では、まっさらな ~/ssrlab/ を新しく作り、最後に丸ごと消します。


作ったアプリを、初めて人に見せたときの話です。

Reactで作った小さな紹介ページを、VMのnginxで配信して、URLをSNSに貼りました。貼った瞬間に出てきたカードには、タイトルも説明文も画像も出ませんでした。 URLの文字列だけがそこにありました。

同じころ、Googleの検索結果にも出てきませんでした。site: で検索しても、トップページだけがヒットして、中身がひとつも入っていない状態でした。

私は最初、サーバーの設定を疑いました。 nginxのMIMEタイプ、キャッシュ、robots.txt、HTTPS。全部見ました。どれも正しかったです。

次に <title> と <meta> を疑いました。Reactの中で document.title = "..." を書いていたので、ブラウザのタブにはちゃんとタイトルが出ていました。 ここで詰まりました。

ブラウザでは正しく見えているのに、外から見ると空。

それに気づいたのは、VMの中でこう打ったときです。

bash
$ curl http://localhost:4173/

返ってきたHTMLに、私が書いた文章がひとつも入っていませんでした。

ブラウザに表示されているものと、サーバーが返しているHTMLは、別のものです。 ブラウザは、返ってきた空のHTMLを受け取ってから、JavaScriptを実行して中身を作っています。 検索エンジンのクローラも、SNSのカード生成も、多くは「返ってきたHTML」しか見ません。

これが、SSRフレームワークが存在する理由です。速さの話ではありません。「HTMLをいつ作るか」の話です。

この記事では、その1点だけを、curl で目に見える形にして確かめます。

対象レベル: 中級〜上級 / 区分: 発展

目次

この記事でわかること

  • ブラウザで見えているものと、サーバーが返しているHTMLは違うこと。そしてその差を確かめる道具が curl であること
  • CSR / SSR / SSG / ISR の違いは「速さ」ではなく「いつHTMLを作るか」であること。ブラウザで作る / リクエストのたびに作る / ビルド時に作る / 一定時間ごとに作り直す、それだけの違い
  • 読み物のサイトに必要なのは、たいていSSRではなくSSGであること。ビルド時にHTMLを吐くだけで、症状の9割は消える
  • ハイドレーションとは何をしているのか。サーバーが作ったHTMLと、ブラウザが最初に作る結果が食い違うと壊れること。window はサーバーに存在しない
  • Next.js / Remix / Astro / TanStack Start は、どれも「HTMLをいつ作るか」を選ばせる道具であること。違うのは、既定値と、置ける場所
  • SSRには代償があること。静的ファイルを置くだけでは動かなくなり、置ける場所が減り、料金が増える

この記事でやること

  1. ~/ssrlab/ を新しく作り、素のReactアプリをビルドして配信し、curl で中身が空であることを目で見る
  2. CSR / SSR / SSG / ISR / ハイドレーション を、1つの軸で表に整理する
  3. SSG を実際にやる。 ビルド時にHTMLを吐かせて、curl の結果に本文が入るところまで確認する
  4. SSR を自分で書く。 Express と renderToString だけで、フレームワークが代行している処理を手で書く
  5. ハイドレーションのズレをわざと起こす。 警告を出し、window is not defined でサーバーを落とし、直す
  6. Next.js を1つだけ入れて触り、curl に本文が返ることを確認する
  7. 代償を書き出し、判断表を作って、~/ssrlab/ を消す

先に知る言葉

基本的な言葉は用語集にもまとめてあります。

言葉意味(この記事での説明)
CSRClient Side Rendering。ブラウザがJavaScriptを実行してHTMLを作るやり方。素のViteのReactアプリはこれ
SSRServer Side Rendering。リクエストが来るたびに、サーバーがHTMLを作って返すやり方
SSGStatic Site Generation。ビルド時にHTMLを作り置きしておくやり方。配信するのはただのファイル
ISRIncremental Static Regeneration。作り置きしたHTMLを、一定時間ごとに裏で作り直すやり方。SSGとSSRの中間
ハイドレーションサーバーが作った動かないHTMLに、ブラウザ側でイベントと状態を後から結びつけること。「水を入れて戻す」の意
renderToStringReactのコンポーネントを、文字列のHTMLに変換する関数。ブラウザではなくサーバーで動く
hydrateRootすでにHTMLがある場所に対して、作り直さずに結びつけるだけのReactの入口。createRoot の代わり
クローラ検索エンジンやSNSが、URLを取りに来るプログラム。多くは返ってきたHTMLしか読まない
OGPSNSにURLを貼ったときのカードの元になる <meta property="og:..."> のこと。HTMLに書いてなければ出ない
curlURLを取りに行って、返ってきたそのままを表示するコマンド。ブラウザと違い、JavaScriptを実行しない

curl がJavaScriptを実行しないことが、この記事の全部です。 curl に見えないものは、クローラにも見えていないと考えて構いません。


① 症状を目で見る — curl の中身が空

まず、症状を再現します。 直す前に、壊れているところを自分の目で見るのが先です。

準備を確認する

bash
$ node -v
$ npm -v

v20 以上が出ればそのまま進めます。出ない、あるいは command not found なら、dist/ の中身は何なのか — ビルドツールとVite の回でNode.jsを入れたところをやり直してください。

作業場所を作る

bash
$ mkdir -p ~/ssrlab
$ cd ~/ssrlab
$ npm create vite@latest app -- --template react
$ cd app
$ npm install

npm create vite が対話で聞いてくることがあります。その場合は React → JavaScript を選びます。

中身を、確かめやすい形に書き換える

src/App.jsx を、次の内容で全部置き換えます。

bash
$ cd ~/ssrlab/app
$ cat > src/App.jsx <<'EOF'
  export default function App() {
    return (
      <main>
        <h1>SSRラボの記事タイトル</h1>
        <p>この文章がHTMLに入っているかどうかを確かめます。</p>
        <p>目印: SSRLAB-MARKER</p>
      </main>
    );
  }
  EOF

SSRLAB-MARKER という目印の文字列を入れました。これから何度も、この文字列がHTMLに入っているかだけを見ます。

ビルドして配信する

bash
$ cd ~/ssrlab/app
$ npm run build
$ npx vite preview --host 0.0.0.0 --port 4173

--host 0.0.0.0 を付けないと、VMの外(ホストのWindows)から見えません。 VMのIPは ip a で確認できます。

別のターミナル(VS Codeからもう1枚SSHを開く、Ctrl+Shift+@ でもよい)を開いて、VMの中で打ちます。

bash
$ curl -s http://localhost:4173/

返ってきたHTMLは、だいたいこうなります。

<!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-XXXXXXXX.js"></script>
    <link rel="stylesheet" crossorigin href="/assets/index-XXXXXXXX.css">
  </head>
  <body>
    <div id="root"></div>
  </body>
</html>

<div id="root"></div> だけです。

念のため、目印を探してみます。

bash
$ curl -s http://localhost:4173/ | grep SSRLAB-MARKER

何も出ません。 終了コードを見るともっとはっきりします。

bash
$ curl -s http://localhost:4173/ | grep -c SSRLAB-MARKER
0

0件です。

📸 スクリーンショット① ブラウザで http://<VMのIP>:4173/ を開いてタイトルが表示されている画面と、 ターミナルで curl -s http://localhost:4173/ | grep -c SSRLAB-MARKER が 0 を返している画面を、 並べて1枚に撮ってください。この記事で一番大事な1枚です。

ブラウザの「ソースを表示」でも同じ

ホストのWindowsのブラウザで http://<VMのIP>:4173/ を開き、Ctrl+U(ページのソースを表示) を押してください。

curl と同じものが出ます。 一方、F12の「要素」タブには <h1> も <p> も見えています。

F12の「要素」タブは、JavaScriptが動いたあとの結果です。 サーバーが返したHTMLではありません。 「ソースを表示」(Ctrl+U)が、サーバーが返したそのものです。ここを混同していると、いつまでも原因にたどり着けません。

サーバーは Ctrl+C で止めておきます。


② 用語を整理する — 違いは「いつHTMLを作るか」だけ

ここで用語を整理します。「SSRは速い」「SSGは速い」という説明は、いったん忘れてください。 速さは結果であって、違いそのものではありません。

違うのは、HTMLを作るタイミングだけです。

やり方いつHTMLを作るか誰が作るかcurl に本文が置ける場所
CSRブラウザで、開いたときに利用者のブラウザ入らない静的ファイル置き場でよい
SSGビルド時に、1回だけ自分のPCやCIサーバー入る静的ファイル置き場でよい
SSRリクエストのたびに動いているサーバー入るNode.jsが動くサーバーが要る
ISRビルド時+一定時間ごとに作り直し動いているサーバー入るNode.jsが動くサーバーが要る

もう1つ、軸を変えた見方をしておきます。

質問CSRSSGSSRISR
内容が人によって違ってよいかよいだめ(全員同じHTML)よいだめ(一定時間は全員同じ)
内容がすぐ変わってよいかよいビルドし直すまで変わらないよい設定した時間で追いつく
サーバーの負荷ほぼ無しほぼ無しアクセス数に比例して増える少ない(作り直したときだけ)
壊れたときに落ちる範囲ブラウザだけ落ちない全員が見られなくなる前の作り置きが残ることがある

SSGは「変わらないもの」に強く、SSRは「人によって違うもの」に強い。 速さで選ぶのではなく、「そのページの中身は、誰にとっても同じか」で選びます。

そして、CSRを捨てるわけではありません。

SSRもSSGも、最初のHTMLを作るだけです。 そのあとブラウザで動くのは、結局Reactです。その繋ぎ目がハイドレーションで、⑤でわざと壊します。

[SSG/SSR]  サーバーがHTMLを作る → ブラウザに届く(この時点で文字は読める・押せない)
                                    ↓ JavaScriptが届いて実行される
[ハイドレーション]                  Reactが既存のHTMLに状態とイベントを結びつける
                                    ↓
[ここから先はCSRと同じ]             クリックで状態が変わる、画面が更新される

③ SSG を実際にやる — 一番簡単で、一番効く

まずSSGをやります。 SSRより先にやる理由は3つあります。

  1. 簡単(サーバーを動かし続ける必要が無い)
  2. 効く(curl に本文が入る、という症状はこれで消える)
  3. このサイト(obmes.com)のような読み物は、これで十分

やることは1行で言えます。ビルドのときに、Reactを文字列のHTMLに変換して、<div id="root"></div> の中に埋め込んでおく。 それだけです。

エントリを2つに分ける

いままで入口は src/main.jsx の1つでした。サーバー用の入口をもう1つ作ります。

bash
$ cd ~/ssrlab/app
$ cat > src/entry-server.jsx <<'EOF'
  import { renderToString } from 'react-dom/server';
  import App from './App.jsx';
  
  export function render() {
    return renderToString(<App />);
  }
  EOF

renderToString は、Reactのコンポーネントを文字列のHTMLにする関数です。ブラウザは登場しません。

次に、ブラウザ側の入口を createRoot から hydrateRoot に変えます。

bash
$ cat > src/main.jsx <<'EOF'
  import { StrictMode } from 'react';
  import { hydrateRoot } from 'react-dom/client';
  import App from './App.jsx';
  import './index.css';
  
  hydrateRoot(document.getElementById('root'), (
    <StrictMode>
      <App />
    </StrictMode>
  ));
  EOF

createRoot は「空の場所に作れ」、hydrateRoot は「もうあるHTMLに結びつけろ」です。 HTMLがすでに入っているのに createRoot を使うと、Reactが中身を全部捨てて作り直します。 一瞬ちらつき、SSGの意味がほぼ無くなります。

目印になる <title> と OGP を入れる

冒頭の症状(SNSにタイトルが出ない)も一緒に潰します。index.html の <head> を書き換えます。

bash
$ cd ~/ssrlab/app
$ cat > index.html <<'EOF'
  <!doctype html>
  <html lang="ja">
    <head>
      <meta charset="UTF-8" />
      <meta name="viewport" content="width=device-width, initial-scale=1.0" />
      <title>SSRラボの記事タイトル</title>
      <meta name="description" content="HTMLがいつ作られるかを確かめる実験ページ" />
      <meta property="og:title" content="SSRラボの記事タイトル" />
      <meta property="og:description" content="HTMLがいつ作られるかを確かめる実験ページ" />
      <meta property="og:type" content="article" />
    </head>
    <body>
      <div id="root"></div>
      <script type="module" src="/src/main.jsx"></script>
    </body>
  </html>
  EOF

OGPは、Reactの中で document.title = "..." と書いても間に合いません。 クローラはJavaScriptを実行しないので、HTMLに書いてある <meta> しか読みません。 これが「SNSに貼ってもカードが出ない」の直接の原因です。

2回ビルドする

ブラウザ用とサーバー用で、ビルドを2回に分けます。

bash
$ cd ~/ssrlab/app
$ npx vite build --outDir dist/client
$ npx vite build --ssr src/entry-server.jsx --outDir dist/server

できたものを見ます。

bash
$ ls dist/client
$ ls dist/server
dist/client:  assets  index.html  vite.svg
dist/server:  entry-server.js

dist/server/entry-server.js は、Node.jsからそのまま読み込めるファイルです。ここが分かれ目です。ブラウザ用のバンドルはNode.jsでは動きません。

ビルド後にHTMLを差し込むスクリプトを書く

bash
$ cd ~/ssrlab/app
$ cat > prerender.mjs <<'EOF'
  import { readFileSync, writeFileSync } from 'node:fs';
  import { render } from './dist/server/entry-server.js';
  
  const template = readFileSync('./dist/client/index.html', 'utf-8');
  const appHtml = render();
  
  const html = template.replace(
    '<div id="root"></div>',
    `<div id="root">${appHtml}</div>`
  );
  
  writeFileSync('./dist/client/index.html', html);
  console.log('prerendered: dist/client/index.html');
  EOF

やっていることは3行です。テンプレートを読む → Reactを文字列にする → 差し込んで書き戻す。

これがSSGの正体です。 ここに難しいことは何もありません。

bash
$ node prerender.mjs
prerendered: dist/client/index.html

curl で確かめる

配信します。

bash
$ npx vite preview --outDir dist/client --host 0.0.0.0 --port 4173

別のターミナルで。

bash
$ curl -s http://localhost:4173/ | grep -c SSRLAB-MARKER
1

入りました。 中身も見ます。

bash
$ curl -s http://localhost:4173/ | grep -A2 '<div id="root">'
<div id="root"><main><h1>SSRラボの記事タイトル</h1><p>この文章がHTMLに入っているかどうかを確かめます。</p><p>目印: SSRLAB-MARKER</p></main></div>

📸 スクリーンショット② ①で撮った grep -c が 0 だった画面と、いまの 1 の画面を、同じ形で撮って並べてください。 「やったこと(prerender.mjs を1本書いた)」に対して「変わったこと」が大きいことが分かります。

ブラウザで開き直して、Ctrl+U で「ソースを表示」してください。今度は本文が見えます。

サーバーは Ctrl+C で止めます。


SSG の出力は HTML と静的ファイルだけなので、置き場所は Node.js が動くサーバーでなくて構いません。スターレンタルサーバーのような共用のレンタルサーバーでも配信でき、ライトプランは 3 ヶ月契約で月額換算 495 円〜36 ヶ月契約で 253 円(税込・2026-11 時点、契約期間分の一括前払い)です。ライトプランは自動バックアップの対象外なので、ビルド元のリポジトリを別に残しておく前提になります。

④ SSR を自分で書く — Express と renderToString だけ

SSGは強力ですが、中身が人によって違うページには使えません。 ログイン後の名前、在庫数、いま何時か。そういうものはビルド時には決まっていません。

そこで SSR、つまり「リクエストのたびにHTMLを作る」をやります。

フレームワークが何を代行しているのかが分かるのは、これを一度自分で書いたときだけです。 ここを飛ばして create-next-app を打つと、動きはしますが、何も分かりません。

Expressを入れる

bash
$ cd ~/ssrlab/app
$ npm install express

サーバーを書く

bash
$ cat > server.mjs <<'EOF'
  import express from 'express';
  import { readFileSync } from 'node:fs';
  import { render } from './dist/server/entry-server.js';
  
  const app = express();
  const template = readFileSync('./dist/client/index.html', 'utf-8');
  
  // ビルド済みのJS・CSSを配信する
  app.use('/assets', express.static('./dist/client/assets'));
  
  app.get('/{*splat}', (req, res) => {   // Express 5 の書き方(4 までは '*')
    const appHtml = render();
    const now = new Date().toISOString();
    const html = template
      .replace(/<div id="root">[\s\S]*?<\/div>/, `<div id="root">${appHtml}</div>`)
      .replace('</body>', `<!-- rendered at ${now} --></body>`);
    res.status(200).set({ 'Content-Type': 'text/html' }).end(html);
  });
  
  app.listen(5188, '0.0.0.0', () => {
    console.log('SSR server: http://localhost:5188');
  });
  EOF

やっていることは③とほぼ同じです。 違いは1つだけ。

  • ③(SSG): ビルドのときに1回 render() を呼んで、ファイルに書く
  • ④(SSR): リクエストが来るたびに render() を呼んで、その場で返す

「いつHTMLを作るか」の違いしかないというのは、こういう意味です。

<!-- rendered at ... --> を末尾に足したのは、「本当に毎回作り直されているのか」を目で見るためです。

動かして確かめる

bash
$ cd ~/ssrlab/app
$ node server.mjs

別のターミナルで。

bash
$ curl -s http://localhost:5188/ | grep -c SSRLAB-MARKER
$ curl -s http://localhost:5188/ | grep 'rendered at'
$ curl -s http://localhost:5188/ | grep 'rendered at'
1
<!-- rendered at 2026-09-29T02:11:40.318Z --></body>
<!-- rendered at 2026-09-29T02:11:41.902Z --></body>

2回打つと、時刻が変わっています。 これが「リクエストのたびに作っている」の証拠です。

③のSSGでは、何度打っても中身は同じです。ファイルを返しているだけだからです。

この差が、そのままサーバー負荷の差です。 SSGは「読んで返す」だけ。SSRはアクセスのたびにReactを実行しています。 1万人が来れば1万回です。

Ctrl+C で止めます。


⑤ ハイドレーションのズレ

ここが本題です。SSRとSSGを入れた人が、最初に必ず踏む地雷です。

サーバーとブラウザで違う結果になるコードを書くと、Reactが壊れます。

わざと壊す

src/App.jsx を書き換えます。

bash
$ cd ~/ssrlab/app
$ cat > src/App.jsx <<'EOF'
  export default function App() {
    const now = new Date().toLocaleTimeString('ja-JP');
    const lucky = Math.floor(Math.random() * 100);
  
    return (
      <main>
        <h1>SSRラボの記事タイトル</h1>
        <p>この文章がHTMLに入っているかどうかを確かめます。</p>
        <p>目印: SSRLAB-MARKER</p>
        <p>いまの時刻: {now}</p>
        <p>今日の数字: {lucky}</p>
      </main>
    );
  }
  EOF

「時刻」と「乱数」です。 どちらも、サーバーで計算した値と、ブラウザで計算した値が一致しません。

ビルドして、SSRサーバーで動かします。

bash
$ cd ~/ssrlab/app
$ npx vite build --outDir dist/client
$ npx vite build --ssr src/entry-server.jsx --outDir dist/server
$ node server.mjs

ホストのWindowsのブラウザで http://<VMのIP>:5188/ を開き、F12でコンソールを見てください。

Warning: Text content did not match. Server: "11:11:40" Client: "20:11:41"
An error occurred during hydration. The server HTML was replaced with client content.

(Reactのバージョンによって文言は変わります。Hydration failed because the server rendered HTML didn't match the client と出ることもあります。)

📸 スクリーンショット③ ブラウザのコンソールに hydration の警告が出ている画面を撮ってください。 この警告を「読める」ようになることが、この記事の到達点です。

何が起きているのか

ハイドレーションでReactがやっているのは、HTMLを作り直すことではありません。

  1. サーバーが作ったHTMLがすでにDOMにある
  2. Reactが同じコンポーネントをブラウザでも1回描画してみる
  3. その結果と、DOMにあるHTMLを突き合わせる
  4. 一致していれば、イベントだけを結びつけて終わり(速い)
  5. 一致していなければ、警告を出して、その部分を作り直す

つまり、「サーバーとブラウザで同じ結果になること」が前提です。時刻も乱数も、その前提を破ります。

直す

答えは1つです。「ブラウザでしか決まらない値は、最初の描画では使わない」。

bash
$ cd ~/ssrlab/app
$ cat > src/App.jsx <<'EOF'
  import { useEffect, useState } from 'react';
  
  export default function App() {
    const [now, setNow] = useState(null);
    const [lucky, setLucky] = useState(null);
  
    useEffect(() => {
      setNow(new Date().toLocaleTimeString('ja-JP'));
      setLucky(Math.floor(Math.random() * 100));
    }, []);
  
    return (
      <main>
        <h1>SSRラボの記事タイトル</h1>
        <p>この文章がHTMLに入っているかどうかを確かめます。</p>
        <p>目印: SSRLAB-MARKER</p>
        <p>いまの時刻: {now ?? '—'}</p>
        <p>今日の数字: {lucky ?? '—'}</p>
      </main>
    );
  }
  EOF

最初の描画は、サーバーもブラウザも — になります。 一致します。 useEffect はサーバーでは実行されないので、ブラウザに届いてから値が入ります。

bash
$ npx vite build --outDir dist/client
$ npx vite build --ssr src/entry-server.jsx --outDir dist/server
$ node server.mjs

ブラウザで開き直すと、警告が消えています。 一瞬 — が見えてから数字に変わります。

「一瞬 — が見える」は不具合ではなく、正しい姿です。 サーバーには「いまの時刻」も「この人のブラウザの幅」も分かりません。 分からないものを、分かっているふりをして書いたのが、さっきの状態でした。

もっと派手に壊す — window はサーバーに無い

次は、そのページをサーバー側で丸ごと失敗させます。

bash
$ cd ~/ssrlab/app
$ cat > src/App.jsx <<'EOF'
  export default function App() {
    const width = window.innerWidth;
  
    return (
      <main>
        <h1>SSRラボの記事タイトル</h1>
        <p>目印: SSRLAB-MARKER</p>
        <p>画面の幅: {width}px</p>
      </main>
    );
  }
  EOF
bash
$ npx vite build --outDir dist/client
$ npx vite build --ssr src/entry-server.jsx --outDir dist/server
$ node server.mjs

ビルドは通ります。 そしてアクセスすると、そのページが 500 エラーになり、サーバーのターミナルにこう出ます(プロセスは落ちません。Express が例外を受け止めています)。

ReferenceError: window is not defined
    at App (file:///home/user/ssrlab/app/dist/server/entry-server.js:...)

window も document も localStorage も、Node.jsには存在しません。 ブラウザが用意しているものだからです。 CSRしか書いていないうちは一度も踏みません。SSRを入れた瞬間に、全部踏みます。

直し方は同じです。ブラウザに届いてから読みます。

bash
$ cd ~/ssrlab/app
$ cat > src/App.jsx <<'EOF'
  import { useEffect, useState } from 'react';
  
  export default function App() {
    const [width, setWidth] = useState(null);
  
    useEffect(() => {
      const update = () => setWidth(window.innerWidth);
      update();
      window.addEventListener('resize', update);
      return () => window.removeEventListener('resize', update);
    }, []);
  
    return (
      <main>
        <h1>SSRラボの記事タイトル</h1>
        <p>目印: SSRLAB-MARKER</p>
        <p>画面の幅: {width === null ? '測定中' : `${width}px`}</p>
      </main>
    );
  }
  EOF
bash
$ npx vite build --outDir dist/client
$ npx vite build --ssr src/entry-server.jsx --outDir dist/server
$ node server.mjs

今度は 500 になりません。curl には 測定中 が入り、ブラウザでは幅に変わります。

bash
$ curl -s http://localhost:5188/ | grep 測定中

これが、SSRを入れると書き方が変わるということの中身です。

サーバーを Ctrl+C で止めます。


⑥ フレームワークを見る — 軸は1つだけ

ここまでで、フレームワークが代行していることが分かりました。

  • ページごとに renderToString を呼ぶ
  • テンプレートに差し込む
  • ブラウザ用とサーバー用のビルドを分ける
  • ルーティングとつなぐ
  • どのページをSSGにして、どれをSSRにするかを選ばせる

5番目が本体です。 名前が違うだけで、どれも「HTMLをいつ作るか」を選ばせる道具です。

得意なこと既定のやり方置ける場所学習コスト
Next.js何でもできる。SSG/SSR/ISRをページ単位で選べるサーバー側で作る(React Server Components)Node.jsが動く場所。Vercelは特に楽高い。独自の決まりが多い
Remix / React Router v7フォームとHTTPに素直。Webの標準に寄せているリクエストのたびに作る(SSR)Node.jsが動く場所ほか中。Web標準を知っていれば速い
Astro読み物。JavaScriptを送らないページが作れるビルド時に作る(SSG)静的ファイル置き場でよい低い。React以外も混ぜられる
TanStack Start型とデータ取得。ルーティングが強いSSR中心、選べるNode.jsが動く場所中〜高。比較的新しい

「どれが優れているか」ではありません。 「そのページのHTMLを、いつ作りたいか」で決まります。 ブログなら Astro(ビルド時)、ECの商品ページなら Next.js の ISR、社内の管理画面なら そもそもCSRのまま、という具合です。

1つだけ触る — Next.js

インストールして触るのは1つでよいです。 全部触っても、分かることは増えません。

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

対話で聞かれたら、JavaScript / App Router / Tailwindなし を選びます。

ページを1つ書き換えます。

bash
$ cd ~/ssrlab/nextlab
$ cat > app/page.js <<'EOF'
  export const metadata = {
    title: 'Nextラボの記事タイトル',
    description: 'HTMLがいつ作られるかを確かめる実験ページ',
  };
  
  export default function Page() {
    return (
      <main>
        <h1>Nextラボの記事タイトル</h1>
        <p>目印: NEXTLAB-MARKER</p>
      </main>
    );
  }
  EOF

ビルドして起動します。

bash
$ npm run build
$ npm run start -- --hostname 0.0.0.0 --port 3000

npm run build の出力に注目してください。ページごとに、どうやってHTMLを作ったかが表で出ます。

Route (app)                              Size     First Load JS
┌ ○ /                                    ...      ...
└ ○ /_not-found                          ...      ...

○  (Static)   prerendered as static content

○ (Static) は、③でやったSSGと同じことです。 ƒ (Dynamic) と出れば、④でやったSSRと同じことです。

別のターミナルで。

bash
$ curl -s http://localhost:3000/ | grep -c NEXTLAB-MARKER
$ curl -s http://localhost:3000/ | grep -o '<title>[^<]*</title>'
1
<title>Nextラボの記事タイトル</title>

③と④で自分の手でやったことが、export const metadata と npm run build に置き換わっただけです。

中で何が起きているか分かっている状態で使うと、フレームワークは道具になります。 分からずに使うと、動いているのに直せないものになります。

Ctrl+C で止めます。


⑦ 代償を正直に書く

SSRフレームワークには、はっきりした代償があります。入れる前に知っておくべきものです。

1. 静的ファイルを置くだけでは動かなくなる

CSRとSSGは、HTMLとJSとCSSを置くだけです。だから静的サイトは本当に無料で出せる — GitHub Pages の回でやったような、無料の置き場所に置けます。

SSRとISRは置けません。 node server.mjs に相当するプロセスが、24時間動き続けている必要があります。

必要なもの落ちたら料金
CSR / SSGファイル置き場だけほぼ落ちない無料の選択肢が多い
SSR / ISRNode.jsが動き続けるサーバー全員が見られない月額が発生する

2. ビルドが遅くなる

④でやったように、ビルドが2回になります。 実際のフレームワークではもっと増えます。

bash
$ # CSRのとき
$ npx vite build --outDir dist/client              # 1回

$ # SSR/SSGのとき
$ npx vite build --outDir dist/client              # ブラウザ用
$ npx vite build --ssr src/entry-server.jsx ...    # サーバー用
$ node prerender.mjs                               # ページ数だけHTMLを作る

ページが1000枚あれば、ビルド時に1000回描画します。 記事が増えるほどビルドが長くなります。

3. サーバー側とブラウザ側の区別を、常に意識することになる

⑤で踏んだやつです。これが一番重いです。

書きたいことCSRだけのときSSRを入れたあと
window.innerWidth を読むそのまま書けるuseEffect の中でしか読めない
localStorage を読むそのまま書ける同上。サーバーには無い
現在時刻を出すそのまま書けるそのままだとハイドレーションがズレる
ライブラリを入れるだいたい動くサーバーで動かないライブラリがある
ログを出すブラウザのコンソールサーバー側のログはターミナルに出る。場所が2つになる

「このコードはどっちで動いているのか」を毎回考える必要があります。 これは慣れの問題ではなく、恒久的に増える負担です。

4. キャッシュの話が難しくなる

SSGならHTMLはただのファイルなので、キャッシュは4箇所にある — Cache-ControlとCDN の回の考え方がそのまま使えます。

SSRは毎回中身が違う可能性があるので、「どこまでキャッシュしてよいか」を自分で決めることになります。 ここを間違えると、他人のログイン後の画面が別の人に見えるという事故になります。


代償 1 の「静的ファイルを置くだけでは動かなくなる」は、置き場所の選び方に直結します。SSR は Node.js のプロセスを動かし続けるサーバーが要るので、シンVPSのような VPS を 1 台用意して、この記事の Express + renderToString をそのまま載せて試すのが分かりやすい方法です。1GB プランで 1 ヶ月契約 月額 750 円〜36 ヶ月契約 451 円(税込・2026-11 時点、2026 年 9 月 1 日の料金改定後)で、無料のお試し期間はありません。

⑧ 判断表 — 「とりあえず Next.js」をやめる

ここまでを1つの表にします。迷ったらこれを見ます。

作るもの選ぶもの理由
ブログ・ドキュメント・紹介ページSSG全員に同じ内容。検索とSNSが効く。サーバーが要らない
ポートフォリオ・個人サイトSSG同上。無料で置ける
ログイン後のダッシュボード・管理画面CSRのままでよい検索に出したくない。 SSRにしても得が無い
社内ツールCSR同上。ログインの向こう側はクローラが来ない
ECの商品一覧・記事が頻繁に変わるメディアSSR / ISR内容が変わる+検索に出したい。両方欲しい場合だけ
ログイン状態で表示が変わる公開ページSSRこれがSSRの本命。ほかに手が無い

「とりあえず Next.js にしておく」をやめる理由は、代償が先に来るからです。 ⑦の1〜4は、SSRの機能を1つも使わなくても、入れた瞬間から全部ついてきます。 得は「使ったページの分だけ」なのに、負担は「全部」です。

「あとで必要になったら」については、こう考えます。

  • CSR → SSG は、③でやったとおりスクリプト1本です。あとから入れられます
  • SSG → SSR も、④でやったとおり同じ render() を呼ぶ場所を変えるだけです
  • 逆(SSRで書いたものをCSRに戻す)が大変です。 サーバー前提のコードが全体に散るからです

だから、迷ったら軽いほうから始めます。


つまずいたところ

1. F12の「要素」タブを見て「HTMLに入っている」と思い込んだ 半日これで潰しました。「要素」タブはJavaScriptが動いたあとの姿です。サーバーが返したものは Ctrl+U(ソースを表示)か curl でしか見えません。この2つを混同している限り、原因には絶対にたどり着けません。

2. hydrateRoot に変え忘れて、SSGの意味が消えていた prerender.mjs を書いてHTMLに本文が入ったのに、ブラウザで開くと一瞬ちらつく。原因は main.jsx が createRoot のままだったことです。createRoot は、そこにあるHTMLを全部捨てて作り直します。 curl の結果だけは正しくなるので、気づきにくいです。

3. --host 0.0.0.0 を付け忘れて、ホストのWindowsから見えなかった VMの中の curl では見えるのに、ブラウザでは繋がらない。VMのネットワークやファイアウォールを疑いましたが、原因は起動オプションでした。vite preview も next start も、既定では自分自身からしか見えません。

4. window is not defined の場所が分からなかった エラーに出るのは dist/server/entry-server.js の行番号で、自分が書いたファイル名ではありません。 ビルドで1つにまとまっているためです。探し方は、grep -rn "window\." src/ で自分のソースを当たるほうが速いです。

5. 時刻のズレの警告を「たまに出るだけだから」と放置した 放置すると、その部分だけReactが作り直します。 表示は合っているように見えますが、サーバーで作ったHTMLが無駄になっているので、SSRを入れた意味がその範囲では消えています。警告は「動いていない印」です。

6. npx vite build --ssr を打ち忘れたまま node server.mjs して古い画面が出た App.jsx を直したのに変わらない。サーバー用のビルドが古いままでした。ビルドが2つあることを忘れると必ず踏みます。⑤では毎回2本とも打つようにしています。

7. Next.jsのビルド表を見ずに「SSRになっている」と思っていた create-next-app で作っただけのページは、多くが ○ (Static)、つまりSSGです。SSRしていると思っていたものが、実はビルド時に作られていました。 npm run build の出力の ○ と ƒ を見る癖をつけると、自分が何を使っているのかが分かります。

8. 静的な置き場所にSSRのビルド結果を上げて、真っ白になった dist を上げれば動くと思っていました。SSRはプロセスが要ります。 「置くだけで動くかどうか」は、選んだやり方で決まっていて、あとから変えられません。


後片づけ

実験用に作ったものを消します。~/ssrlab/ の中だけです。

まず、動いているサーバーが残っていないか確認します。

bash
$ ss -ltnp | grep -E '4173|5188|3000'

何か出たら、そのターミナルで Ctrl+C を押すか、表示されたPIDを止めます。

bash
$ pkill -f "vite preview"
$ pkill -f "server.mjs"
$ pkill -f "next start"

中身を確認してから消します。

bash
$ ls ~/ssrlab
$ du -sh ~/ssrlab
app  nextlab
620M	/home/user/ssrlab

node_modules が2つ分あるので、数百MBあります。 消します。

bash
$ rm -rf ~/ssrlab
$ ls ~ | grep ssrlab

何も出なければ完了です。~/react-demo/ や ~/reactlab/ には触っていません。

rm -rf は打つ前にパスを声に出して読んでください。 ホームディレクトリの中の ssrlab だけです。


まとめ — 理解できたこと

  • ブラウザに表示されているものと、サーバーが返しているHTMLは別のもの。 F12の「要素」タブはJavaScriptが動いたあと、Ctrl+U と curl はサーバーが返したそのもの
  • curl はJavaScriptを実行しない。 だから curl に見えないものは、クローラにも見えていないと考えてよい
  • 素のReactアプリが返すHTMLは <div id="root"></div> だけ。 これが「検索に出ない」「SNSにタイトルが出ない」の直接の原因
  • OGPと <title> は、HTMLに書いてなければ出ない。 Reactの中で document.title を書いても、クローラには間に合わない
  • CSR / SSG / SSR / ISR の違いは「いつHTMLを作るか」だけ。 ブラウザで作る / ビルド時に作る / リクエストのたびに作る / 一定時間ごとに作り直す
  • SSGの正体は、ビルド時に renderToString を1回呼んで、テンプレートに差し込むこと。 スクリプト1本で書ける
  • SSRの正体は、同じ render() を「リクエストのたびに」呼ぶこと。 SSGとの差はそこだけ
  • ハイドレーションは、HTMLを作り直すのではなく「突き合わせて、イベントを結びつける」処理。 突き合わせに失敗すると、その部分は作り直しになる
  • サーバーとブラウザで違う結果になる値(時刻・乱数)を最初の描画で使うと、必ずズレる。 useEffect に逃がす
  • window も document も localStorage も、Node.jsには存在しない。 CSRだけのときは一度も踏まないが、SSRを入れた瞬間に全部踏む
  • Next.js / Remix / Astro / TanStack Start は、どれも「HTMLをいつ作るか」を選ばせる道具。 違うのは既定値と、置ける場所と、学習コスト
  • SSRの代償は4つ。 Node.jsが動くサーバーが要る・ビルドが遅くなる・どっちで動くコードか常に意識する・キャッシュが難しくなる
  • 読み物はSSG、ログインの向こう側はCSRのままでよい。 SSR/ISRが本当に要るのは「内容が変わる」かつ「検索に出したい」ページだけ
  • 迷ったら軽いほうから始める。 CSR→SSG→SSRは後から進めるが、SSRからは戻りにくい

参考リンク


次に読む

この記事は 【深掘り】React の 21 / 24 本目です。

記事
← 前の記事Reactのルーティング — リロードで最初の画面に戻る
→ 次の記事Reactのアニメーション — 動きを付けたらカクついた

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

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

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

›React — SSR Frameworks
  • CSR / SSR / SSG / ISR はHTMLをいつ作るか
  • ハイドレーションのズレを再現する

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

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

コメント

コメントする

目次