※本記事はアフィリエイト広告(PR)を含みます。
SNSに貼るとタイトルが出ないのは、HTMLが空で返っているからです。SSRとSSGが何を肩代わりしているのかを確かめます。
これは【深掘り】の記事です。本線の順路ではありません。 本線の 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の中でこう打ったときです。
返ってきた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には代償があること。静的ファイルを置くだけでは動かなくなり、置ける場所が減り、料金が増える
この記事でやること
~/ssrlab/を新しく作り、素のReactアプリをビルドして配信し、curlで中身が空であることを目で見る- CSR / SSR / SSG / ISR / ハイドレーション を、1つの軸で表に整理する
- SSG を実際にやる。 ビルド時にHTMLを吐かせて、
curlの結果に本文が入るところまで確認する - SSR を自分で書く。 Express と
renderToStringだけで、フレームワークが代行している処理を手で書く - ハイドレーションのズレをわざと起こす。 警告を出し、
window is not definedでサーバーを落とし、直す - Next.js を1つだけ入れて触り、
curlに本文が返ることを確認する - 代償を書き出し、判断表を作って、
~/ssrlab/を消す
先に知る言葉
基本的な言葉は用語集にもまとめてあります。
| 言葉 | 意味(この記事での説明) |
|---|---|
| CSR | Client Side Rendering。ブラウザがJavaScriptを実行してHTMLを作るやり方。素のViteのReactアプリはこれ |
| SSR | Server Side Rendering。リクエストが来るたびに、サーバーがHTMLを作って返すやり方 |
| SSG | Static Site Generation。ビルド時にHTMLを作り置きしておくやり方。配信するのはただのファイル |
| ISR | Incremental Static Regeneration。作り置きしたHTMLを、一定時間ごとに裏で作り直すやり方。SSGとSSRの中間 |
| ハイドレーション | サーバーが作った動かないHTMLに、ブラウザ側でイベントと状態を後から結びつけること。「水を入れて戻す」の意 |
renderToString | Reactのコンポーネントを、文字列のHTMLに変換する関数。ブラウザではなくサーバーで動く |
hydrateRoot | すでにHTMLがある場所に対して、作り直さずに結びつけるだけのReactの入口。createRoot の代わり |
| クローラ | 検索エンジンやSNSが、URLを取りに来るプログラム。多くは返ってきたHTMLしか読まない |
| OGP | SNSにURLを貼ったときのカードの元になる <meta property="og:..."> のこと。HTMLに書いてなければ出ない |
curl | URLを取りに行って、返ってきたそのままを表示するコマンド。ブラウザと違い、JavaScriptを実行しない |
curlがJavaScriptを実行しないことが、この記事の全部です。curlに見えないものは、クローラにも見えていないと考えて構いません。
① 症状を目で見る — curl の中身が空
まず、症状を再現します。 直す前に、壊れているところを自分の目で見るのが先です。
準備を確認する
v20 以上が出ればそのまま進めます。出ない、あるいは command not found なら、dist/ の中身は何なのか — ビルドツールとVite の回でNode.jsを入れたところをやり直してください。
作業場所を作る
npm create vite が対話で聞いてくることがあります。その場合は React → JavaScript を選びます。
中身を、確かめやすい形に書き換える
src/App.jsx を、次の内容で全部置き換えます。
SSRLAB-MARKER という目印の文字列を入れました。これから何度も、この文字列がHTMLに入っているかだけを見ます。
ビルドして配信する
--host 0.0.0.0 を付けないと、VMの外(ホストのWindows)から見えません。 VMのIPは ip a で確認できます。
別のターミナル(VS Codeからもう1枚SSHを開く、Ctrl+Shift+@ でもよい)を開いて、VMの中で打ちます。
返ってきた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> だけです。
念のため、目印を探してみます。
何も出ません。 終了コードを見るともっとはっきりします。
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つ、軸を変えた見方をしておきます。
| 質問 | CSR | SSG | SSR | ISR |
|---|---|---|---|---|
| 内容が人によって違ってよいか | よい | だめ(全員同じHTML) | よい | だめ(一定時間は全員同じ) |
| 内容がすぐ変わってよいか | よい | ビルドし直すまで変わらない | よい | 設定した時間で追いつく |
| サーバーの負荷 | ほぼ無し | ほぼ無し | アクセス数に比例して増える | 少ない(作り直したときだけ) |
| 壊れたときに落ちる範囲 | ブラウザだけ | 落ちない | 全員が見られなくなる | 前の作り置きが残ることがある |
SSGは「変わらないもの」に強く、SSRは「人によって違うもの」に強い。 速さで選ぶのではなく、「そのページの中身は、誰にとっても同じか」で選びます。
そして、CSRを捨てるわけではありません。
SSRもSSGも、最初のHTMLを作るだけです。 そのあとブラウザで動くのは、結局Reactです。その繋ぎ目がハイドレーションで、⑤でわざと壊します。
[SSG/SSR] サーバーがHTMLを作る → ブラウザに届く(この時点で文字は読める・押せない)
↓ JavaScriptが届いて実行される
[ハイドレーション] Reactが既存のHTMLに状態とイベントを結びつける
↓
[ここから先はCSRと同じ] クリックで状態が変わる、画面が更新される
③ SSG を実際にやる — 一番簡単で、一番効く
まずSSGをやります。 SSRより先にやる理由は3つあります。
- 簡単(サーバーを動かし続ける必要が無い)
- 効く(
curlに本文が入る、という症状はこれで消える) - このサイト(obmes.com)のような読み物は、これで十分
やることは1行で言えます。ビルドのときに、Reactを文字列のHTMLに変換して、<div id="root"></div> の中に埋め込んでおく。 それだけです。
エントリを2つに分ける
いままで入口は src/main.jsx の1つでした。サーバー用の入口をもう1つ作ります。
renderToString は、Reactのコンポーネントを文字列のHTMLにする関数です。ブラウザは登場しません。
次に、ブラウザ側の入口を createRoot から hydrateRoot に変えます。
createRootは「空の場所に作れ」、hydrateRootは「もうあるHTMLに結びつけろ」です。 HTMLがすでに入っているのにcreateRootを使うと、Reactが中身を全部捨てて作り直します。 一瞬ちらつき、SSGの意味がほぼ無くなります。
目印になる <title> と OGP を入れる
冒頭の症状(SNSにタイトルが出ない)も一緒に潰します。index.html の <head> を書き換えます。
OGPは、Reactの中で
document.title = "..."と書いても間に合いません。 クローラはJavaScriptを実行しないので、HTMLに書いてある<meta>しか読みません。 これが「SNSに貼ってもカードが出ない」の直接の原因です。
2回ビルドする
ブラウザ用とサーバー用で、ビルドを2回に分けます。
できたものを見ます。
dist/client: assets index.html vite.svg
dist/server: entry-server.js
dist/server/entry-server.js は、Node.jsからそのまま読み込めるファイルです。ここが分かれ目です。ブラウザ用のバンドルはNode.jsでは動きません。
ビルド後にHTMLを差し込むスクリプトを書く
やっていることは3行です。テンプレートを読む → Reactを文字列にする → 差し込んで書き戻す。
これがSSGの正体です。 ここに難しいことは何もありません。
prerendered: dist/client/index.html
curl で確かめる
配信します。
別のターミナルで。
1
入りました。 中身も見ます。
<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を入れる
サーバーを書く
やっていることは③とほぼ同じです。 違いは1つだけ。
- ③(SSG): ビルドのときに1回
render()を呼んで、ファイルに書く - ④(SSR): リクエストが来るたびに
render()を呼んで、その場で返す
「いつHTMLを作るか」の違いしかないというのは、こういう意味です。
<!-- 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 を書き換えます。
「時刻」と「乱数」です。 どちらも、サーバーで計算した値と、ブラウザで計算した値が一致しません。
ビルドして、SSRサーバーで動かします。
ホストの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を作り直すことではありません。
- サーバーが作ったHTMLがすでにDOMにある
- Reactが同じコンポーネントをブラウザでも1回描画してみる
- その結果と、DOMにあるHTMLを突き合わせる
- 一致していれば、イベントだけを結びつけて終わり(速い)
- 一致していなければ、警告を出して、その部分を作り直す
つまり、「サーバーとブラウザで同じ結果になること」が前提です。時刻も乱数も、その前提を破ります。
直す
答えは1つです。「ブラウザでしか決まらない値は、最初の描画では使わない」。
最初の描画は、サーバーもブラウザも — になります。 一致します。 useEffect はサーバーでは実行されないので、ブラウザに届いてから値が入ります。
ブラウザで開き直すと、警告が消えています。 一瞬 — が見えてから数字に変わります。
「一瞬
—が見える」は不具合ではなく、正しい姿です。 サーバーには「いまの時刻」も「この人のブラウザの幅」も分かりません。 分からないものを、分かっているふりをして書いたのが、さっきの状態でした。
もっと派手に壊す — window はサーバーに無い
次は、そのページをサーバー側で丸ごと失敗させます。
ビルドは通ります。 そしてアクセスすると、そのページが 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を入れた瞬間に、全部踏みます。
直し方は同じです。ブラウザに届いてから読みます。
今度は 500 になりません。curl には 測定中 が入り、ブラウザでは幅に変わります。
これが、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つでよいです。 全部触っても、分かることは増えません。
対話で聞かれたら、JavaScript / App Router / Tailwindなし を選びます。
ページを1つ書き換えます。
ビルドして起動します。
npm run build の出力に注目してください。ページごとに、どうやってHTMLを作ったかが表で出ます。
Route (app) Size First Load JS
┌ ○ / ... ...
└ ○ /_not-found ... ...
○ (Static) prerendered as static content
○ (Static) は、③でやったSSGと同じことです。 ƒ (Dynamic) と出れば、④でやったSSRと同じことです。
別のターミナルで。
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 / ISR | Node.jsが動き続けるサーバー | 全員が見られない | 月額が発生する |
2. ビルドが遅くなる
④でやったように、ビルドが2回になります。 実際のフレームワークではもっと増えます。
ページが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/ の中だけです。
まず、動いているサーバーが残っていないか確認します。
何か出たら、そのターミナルで Ctrl+C を押すか、表示されたPIDを止めます。
中身を確認してから消します。
app nextlab
620M /home/user/ssrlab
node_modules が2つ分あるので、数百MBあります。 消します。
何も出なければ完了です。~/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 公式 —
renderToString - React 公式 —
hydrateRoot - Vite 公式 — Server-Side Rendering
- Vite 公式 — Building for Production
- Next.js 公式ドキュメント
- Astro 公式サイト
- TanStack Start
- MDN —
<meta>要素 - MDN — Window
- roadmap.sh — React
次に読む
この記事は 【深掘り】React の 21 / 24 本目です。
| 記事 | |
|---|---|
| ← 前の記事 | Reactのルーティング — リロードで最初の画面に戻る |
| → 次の記事 | Reactのアニメーション — 動きを付けたらカクついた |
上から順に読めば積み上がるように並べています。 飛ばしても構いませんが、詰まったら前の回に戻ってください。
全体の順路は はじめに にあります。
roadmap.sh のどこをやっているか
- CSR / SSR / SSG / ISR はHTMLをいつ作るか
- ハイドレーションのズレを再現する
この記事は、上の項目を実際に手を動かして確かめる回です。

コメント