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

Reactのルーティング。アドレス欄付きのブラウザと複数のページカード、戻るボタンのマーク。

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

リロードすると最初の画面に戻るのは、サーバーがそのURLを知らないからです。ルーティングの仕組みをサーバー設定まで降りて見ます。

前回: ReactとTypeScript — anyを1つで型検査が消える

これは【深掘り】の記事です。本線の順路ではありません。 本線のルーティングの回で「/tasks/3 を直接開くと404」までやった人が、それが「なぜ」起きるのかを、サーバーの設定ファイルまで降りて確かめたくなったときに読む記事です。飛ばしても本線は進みます。

この記事のコマンドは、VMの中(Ubuntu Server)で打ちます。 Windows の PowerShell ではありません。画面の確認だけ、ホストのWindowsのブラウザで行います。 作業場所はまっさらな ~/routelab/ で、開発サーバーは 5190 / 5191番、本番配信は 8190番を使います。本線で作った ~/react-demo/ には触りません。 最後に全部消します。


私が最初に作った「ページが複数あるReactアプリ」は、こういうものでした。

const [page, setPage] = useState('home');

ボタンを押すと page が変わって、表示が切り替わる。 それだけです。動きました。速いです。画面がパッと変わるのが気持ちよくて、「SPAってこういうことか」と思いました。

壊れたのは、人に見せたときです。

「この一覧のここ、見てほしいんだけど」と思って、URLをコピーして送りました。 相手が開いたら、トップページでした。 私が見ていた画面ではありません。

そのあと自分でも踏みました。詳細画面でF5を押したら、トップに戻りました。 入力途中のものが全部消えました。そして戻るボタンを押したら、アプリの中の1つ前ではなく、その前に見ていた別のサイトに戻りました。

バグではありません。 私はブラウザに何も伝えていなかっただけです。 page はReactのメモリの中にしかない値で、アドレスバーは最初のURLのまま止まっていました。 ブラウザから見れば、私は1つのページをずっと開いているだけです。だからリロードすれば最初に戻るし、URLを送っても何も伝わらないし、履歴も増えていません。

つまり、「ページを移動している」のは私の頭の中だけでした。

ルーターが何をする道具なのかは、ここまで分かってから入れないと意味がありません。「これを入れると画面が切り替わる」ではなく、「切り替わっているように見せた状態を、ブラウザの持ち物(URL・履歴)と一致させ続ける」道具です。

この記事では、まずその3つの症状を自分の手で出します。 そのあと、ルーターを入れずに history.pushState を素で書いて、ルーターが代わりにやっている仕事を先に知ります。 そこからが本題です。

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

目次

この記事でわかること

  • 「リロードで戻る・共有できない・戻るボタンが効かない」は、3つの別のバグではなく、1つの原因の3つの見え方であること。URLを更新していないだけ
  • ルーターの正体は history.pushState と popstate の薄い皮であること。Reactの機能ではなく、ブラウザに前からある機能を包んでいる
  • <a href> を使うとページ全体が再読み込みされること。Link はそれを止めて、URLだけ書き換えている。Networkタブで一目で分かる
  • 山場: ビルドして本番配信すると /users/1 を直接開いた瞬間に404になること。サーバーが /users/1 という名前のファイルを本気で探しに行くからで、Reactは一切関係ない
  • その直し方は try_files $uri $uri/ /index.html; の1行であること。ただし「全部 index.html を返す」にすると、本物の404も画像の欠けも消えてしまう
  • 画面が出てから useEffect で取ると、ローディングが階段状に出ること。親が出る → 子が出る → やっと中身、と待ち時間が直列に積み上がる
  • ルーターの loader は「遷移する前に取る」こと。速くなるのは通信が速いからではなく、待つ順番が変わるから
  • TanStack Router の最大の違いは速さでも軽さでもなく「型」であること。存在しないパスへの Link が、実行する前にビルドで落ちる
  • パラメータ(/users/:id の id)にも型が付くこと。React Router では params.id は常に string \| undefined で、綴りを間違えても誰も止めてくれない
  • 画面が3枚なら、ルーターは入れなくてもよいこと。入れる理由は画面数ではなく「URLで指せる必要があるか」

この記事でやること

  1. ~/routelab/ を新しく作り、素のReactで3つの症状(リロード・共有・戻る)を実際に出す
  2. history.pushState と popstate を素で書いて、ルーター無しでURLを合わせる
  3. React Router を入れて、Link / 動的セグメント / ネストと Outlet / 404ルートまで作る
  4. ビルドして 8190番で配信し、/users/1 を直接開いて404を再現する。 nginx の設定ファイルの全文を出して直す
  5. useEffect で取る形と loader で取る形を並べて、ローディングの出方を比べる
  6. 同じ画面を TanStack Router(TypeScript)で作り直し、存在しないパスへの Link がビルドで落ちるところを出す
  7. 表で比べて、何を選ぶかを決める

先に知る言葉

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

言葉意味
SPASingle Page Application。最初に1枚のHTMLだけ読み込み、あとはJavaScriptが中身を書き換え続ける作り
ルーティングURLと、画面に出すものの対応を決めること。「/users/1 ならユーザー詳細」
History APIブラウザが前から持っている、アドレスバーと履歴を書き換える機能。pushState など
pushStateページを読み込み直さずに、URLと履歴を1つ進める命令。ルーターの心臓部
popstate戻る・進むが押されたときに起きるイベント。これを拾わないと戻るボタンが効かない
動的セグメント/users/:id の :id の部分。URLの一部を値として受け取る書き方
ネストルート画面の一部だけを差し替える入れ子構造。共通のヘッダを残したまま中身を変える
Outletネストしたとき、子の画面がここに入るという差し込み口
try_filesnginx の設定。ファイルを順に探して、無ければ最後のものを返す
ウォーターフォール通信が滝のように直列に並ぶこと。1つ終わってから次が始まるので、待ち時間が足し算になる

① 症状を3つとも自分で出す

まず、ルーター無しのアプリを作ります。 ここを飛ばすと、あとの話が「そういうものらしい」で終わります。

bash
$ cd ~
$ npm create vite@latest routelab-tmp -- --template react

質問が出たら、そのままEnterで進めて構いません。作られたものを、この記事用のフォルダに移します。

bash
$ mkdir -p ~/routelab
$ mv ~/routelab-tmp ~/routelab/rr-app
$ cd ~/routelab/rr-app
$ npm install

確認: ls して src と package.json が見えれば成功です。

vite の開発サーバーは、既定ではVMの中からしか見えません。 ホストのWindowsのブラウザで開くので、外から見えるようにします。

bash
$ cd ~/routelab/rr-app
$ npm run dev -- --host 0.0.0.0 --port 5190

別のターミナルを開いて、ポートを通します。

bash
$ sudo ufw allow 5190/tcp
$ sudo ufw status

確認: 5190/tcp ALLOW が一覧に出れば通っています。VMのIPは ip a で確認してください。ホストのブラウザで http://<VMのIP>:5190/ を開いて、Viteの初期画面が出れば準備完了です。

では、ルーター無しの「切り替え」を書きます。

bash
$ cd ~/routelab/rr-app
$ nano src/App.jsx

中身を全部消して、これに置き換えます。

import { useState } from 'react';

function Home() {
  return <p>トップページです。</p>;
}

function Users() {
  return <p>ユーザー一覧です。</p>;
}

function About() {
  return <p>このサイトについて。</p>;
}

export default function App() {
  const [page, setPage] = useState('home');

  return (
    <div style={{ fontFamily: 'sans-serif', padding: 24 }}>
      <h1>routelab</h1>
      <nav style={{ display: 'flex', gap: 12, marginBottom: 16 }}>
        <button onClick={() => setPage('home')}>トップ</button>
        <button onClick={() => setPage('users')}>ユーザー</button>
        <button onClick={() => setPage('about')}>About</button>
      </nav>

      {page === 'home' && <Home />}
      {page === 'users' && <Users />}
      {page === 'about' && <About />}

      <hr />
      <p>いま表示中: <strong>{page}</strong></p>
    </div>
  );
}

保存して、ブラウザで開きます。ボタンを押すと表示が変わります。 ちゃんと動いています。

ここから、3回壊します。

症状1: リロードすると最初に戻る。 「ユーザー」ボタンを押して、ユーザー一覧を出してください。その状態で F5 を押します。

→ トップページに戻ります。

症状2: URLを共有できない。 「About」を押した状態で、アドレスバーを見てください。

→ http://<VMのIP>:5190/ のままです。トップにいたときと1文字も変わっていません。 これをコピーして誰かに送っても、相手はトップを見ます。

症状3: 戻るボタンが効かない。 トップ → ユーザー → About と3回押してから、ブラウザの戻るボタンを押します。

→ アプリの中では何も起きず、このページを開く前に見ていたページに戻ります。

📸 スクリーンショット指示: 「About」を表示した状態で、アドレスバーが / のままであることが写るように、ブラウザの上部を含めて撮ってください。この記事で一番大事な1枚です。

3つとも、原因は同じ1つです。

症状何が起きているか
リロードで戻るpage はメモリの中の値なので、読み込み直すと初期値に戻る
共有できないURLに情報が入っていないので、送っても何も伝わらない
戻るが効かない履歴を1つも積んでいないので、ブラウザは「前のサイト」に戻るしかない

「状態はReactが持ち、URLはブラウザが持つ」。この2つがズレているのが正体です。 ルーターとは、この2つを常に一致させ続ける仕組みのことです。


② ルーターを入れる前に、History API を素で触る

先にライブラリを入れると、「魔法で直った」で終わります。 何を代行してもらうのかを、先に自分の手で1回書きます。

使うのはブラウザが前から持っている機能です(MDN — History API)。Reactの機能でも、ライブラリの機能でもありません。

src/App.jsx を、もう一度全部置き換えます。

bash
$ nano src/App.jsx
import { useState, useEffect } from 'react';

function Home() {
  return <p>トップページです。</p>;
}

function Users() {
  return <p>ユーザー一覧です。</p>;
}

function About() {
  return <p>このサイトについて。</p>;
}

export default function App() {
  // ① 初期値をメモリではなく「いまのURL」から作る
  const [path, setPath] = useState(window.location.pathname);

  // ② 戻る・進むが押されたら、URLを読み直して状態に反映する
  useEffect(() => {
    const onPop = () => setPath(window.location.pathname);
    window.addEventListener('popstate', onPop);
    return () => window.removeEventListener('popstate', onPop);
  }, []);

  // ③ 画面を変えるときは、状態とURLの両方を変える
  const go = (to) => {
    window.history.pushState({}, '', to);
    setPath(to);
  };

  return (
    <div style={{ fontFamily: 'sans-serif', padding: 24 }}>
      <h1>routelab</h1>
      <nav style={{ display: 'flex', gap: 12, marginBottom: 16 }}>
        <button onClick={() => go('/')}>トップ</button>
        <button onClick={() => go('/users')}>ユーザー</button>
        <button onClick={() => go('/about')}>About</button>
      </nav>

      {path === '/' && <Home />}
      {path === '/users' && <Users />}
      {path === '/about' && <About />}

      <hr />
      <p>いまのURL: <strong>{path}</strong></p>
    </div>
  );
}

保存して、もう一度3つの症状を確かめます。

  • ボタンを押すと、アドレスバーが /users に変わります。 共有できます
  • 戻るボタンが効きます。 アプリの中で1つ前の画面に戻ります
  • リロードは……まだ直っていません。 開発サーバーでは F5 でも正しく出ますが、ビルドして普通のサーバーで配ると、④で見る理由で404になります

書いたのは3か所だけです。

番号やったことルーターが代わりにやること
①初期値をURLから作る起動時にURLを読んでルートを決める
②popstate を拾って状態に戻す戻る・進むへの追従
③pushState とセットで状態を変えるLink を押したときの処理

ルーターは「Reactにページ機能を足すもの」ではありません。 ブラウザが前から持っている History API を、宣言的に書けるように包んだだけです。だから「Reactのルーティングが分からない」の半分は、History API を知らないという話です。

そして、この3行だけでは足りないものが、すぐに見えてきます。

  • /users/1 のような動的なパスを、=== では書けない
  • 共通のヘッダを残したまま中身だけ差し替えるのを、条件分岐でやると入れ子が地獄になる
  • どれにも当たらないときの404を、毎回自分で書くことになる
  • 相対パス、クエリ文字列、スクロール位置の復元、遷移中の表示

ここまで自分で書くと、ライブラリを入れる理由が「楽だから」ではなく「同じものを自分で書くと確実にバグらせるから」に変わります。


③ React Router を入れる

一番使われているものから入れます。

bash
$ cd ~/routelab/rr-app
$ npm install react-router-dom
$ npm ls react-router-dom

確認: react-router-dom@7.x.x のようにバージョンが表示されれば入っています。このあとの書き方は、いま入ったバージョンのドキュメント(React Router 公式)で必ず確認してください。Reactのルーターは書き方が何度も変わっている領域で、古い記事のコードがそのまま動かないことがよくあります。

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

bash
$ nano src/App.jsx
import {
  BrowserRouter,
  Routes,
  Route,
  Link,
  Outlet,
  useParams,
} from 'react-router-dom';

const users = [
  { id: 1, name: 'sato', role: '管理者' },
  { id: 2, name: 'suzuki', role: '一般' },
  { id: 3, name: 'takahashi', role: '一般' },
];

function Layout() {
  return (
    <div style={{ fontFamily: 'sans-serif', padding: 24 }}>
      <h1>routelab</h1>
      <nav style={{ display: 'flex', gap: 12, marginBottom: 16 }}>
        <Link to="/">トップ</Link>
        <Link to="/users">ユーザー</Link>
        <Link to="/about">About</Link>
        {/* ⚠️ わざと素のリンクも置く。あとで違いを見る */}
        <a href="/about">About(素のa)</a>
      </nav>
      <hr />
      {/* 子のルートがここに入る */}
      <Outlet />
    </div>
  );
}

function Home() {
  return <p>トップページです。</p>;
}

function About() {
  return <p>このサイトについて。</p>;
}

function UserList() {
  return (
    <ul>
      {users.map((u) => (
        <li key={u.id}>
          <Link to={`/users/${u.id}`}>{u.name}</Link>
        </li>
      ))}
    </ul>
  );
}

function UserDetail() {
  const { id } = useParams();
  const user = users.find((u) => String(u.id) === id);

  if (!user) return <p>そのユーザーはいません(id: {id})</p>;

  return (
    <div>
      <h2>{user.name}</h2>
      <p>役割: {user.role}</p>
      <p>URLから受け取ったid: <strong>{id}</strong></p>
      <Link to="/users">一覧へ戻る</Link>
    </div>
  );
}

function NotFound() {
  return <p>ページが見つかりません(404)</p>;
}

export default function App() {
  return (
    <BrowserRouter>
      <Routes>
        <Route path="/" element={<Layout />}>
          <Route index element={<Home />} />
          <Route path="about" element={<About />} />
          <Route path="users">
            <Route index element={<UserList />} />
            <Route path=":id" element={<UserDetail />} />
          </Route>
          <Route path="*" element={<NotFound />} />
        </Route>
      </Routes>
    </BrowserRouter>
  );
}

保存して、ブラウザで確かめます。

  • /users を開いて、名前をクリック → /users/2 に移動して、詳細が出ます
  • アドレスバーが変わり、戻るボタンも効きます
  • /nosuchpage を手で打つと(開発サーバーなら)404の表示になります
  • <h1>routelab</h1> とナビは、どの画面でも消えません。 これが Outlet の効果です

Link と <a> の違いを、目で見る

ナビにわざと素の <a href="/about"> を混ぜてあります。 これを見るために、ブラウザの開発者ツールを開きます(開発者ツールの回)。

  1. F12 を押して、Network タブを開く
  2. 左上の 🚫(クリア) を押して、いったん空にする
  3. Link の「About」を押す → 通信が1本も増えません(あるいはデータ取得だけ)
  4. もう一度クリアして、「About(素のa)」を押す → about というドキュメントの取得が走り、その下にJSとCSSがぶら下がります

📸 スクリーンショット指示: Networkタブを2枚。Link を押したあと(ほぼ空)と、<a> を押したあと(ドキュメント+JS+CSSが並ぶ)を並べて撮ってください。

これがSPAで一番よくある「なぜか遅い」の正体です。 <a href> はブラウザの標準の動きで、ページ全体を捨てて読み込み直します。 アプリの状態は全部消え、JavaScriptも再実行されます。見た目は同じ画面に着くので、気づきません。

Link は、内部で <a> を描いたうえで、クリックの既定の動作を止めて pushState を呼んでいるだけです。②で自分の手で書いたものと、やっていることは同じです。

外部サイトへのリンクは <a> のままで正解です。 アプリの中の移動だけ Link にします。


④ ビルドすると /users/1 が404になる

ここがこの記事の本題です。 開発サーバーでは全部動いています。そのまま本番に出すと、ほぼ確実に踏みます。

まずビルドします。

bash
$ cd ~/routelab/rr-app
$ npm run build
$ ls -R dist | head -20

確認: dist/index.html と dist/assets/ ができています。HTMLは index.html の1枚しかありません。 ここが伏線です(ビルドツールの回)。

dist を、普通の静的ファイル配信で出してみます。まずは手軽なほうから。

bash
$ cd ~/routelab/rr-app
$ npx serve -l 5191 dist

別のターミナルでポートを通します。

bash
$ sudo ufw allow 5191/tcp

ホストのブラウザで http://<VMのIP>:5191/ を開きます。

  • トップは出ます
  • Link で /users/1 まで進めます。 ここまでは正常です
  • その状態で F5 を押してください。

→ 404 です。

アドレスバーに http://<VMのIP>:5191/users/1 と直接打ち込んでも、同じく404です。人に送ったURLも、全部これになります。

なぜか。 順番に考えます。

  1. ブラウザはサーバーに GET /users/1 を送る
  2. サーバーは「/users/1 というファイル」を探す
  3. dist の中には index.html と assets/ しかない
  4. 見つからないので 404 を返す

サーバーは、React Router のルート定義を1文字も知りません。 ルート定義は dist/assets/index-xxxx.js の中にあり、そのJSが動くのはHTMLが返ってからです。 HTMLが返らないので、ルーターは存在すらしていません。

Link で移動したときに動いたのは、すでにJSが動いていたからです。だから「開発では動くのに、直接開くと404」になります。

これはReactのバグでもnginxのバグでもありません。 SPAという作りの、当然の帰結です。

直し方の考え方

サーバーに1つだけ教えます。

「そのファイルが無かったら、404を返さずに index.html を返して」

index.html が返れば、JSが動き、ルーターが起動し、ルーターが window.location.pathname(= /users/1)を見て、正しい画面を出します。②で自分で書いた「初期値をURLから作る」の部分が、ここで効きます。

serve なら1つのオプションで済みます。

bash
$ # いったん Ctrl+C で止めてから
$ npx serve -s -l 5191 dist

-s は single(SPAモード)です。もう一度 /users/1 を直接開いてください。 今度は出ます。

確認: F5でも、アドレスバーへの直接入力でも、詳細画面が出れば直っています。

nginx でやる(本番はこちら)

serve は開発用の道具です。本番は nginx で配信します(nginxの回)。

まず、ビルド結果を置く場所を作ってコピーします。

bash
$ sudo mkdir -p /var/www/routelab
$ sudo cp -r ~/routelab/rr-app/dist/* /var/www/routelab/
$ ls /var/www/routelab

確認: index.html と assets が見えればOKです。

設定ファイルを新しく作ります。 既存の設定は触りません。

bash
$ sudo nano /etc/nginx/sites-available/routelab

「先頭に足してください」ではなく、このファイルの全文です。 中身を全部これにしてください。

まず、わざと壊れている(直す前の)状態から始めます。

server {
    listen 8190;
    server_name _;

    root /var/www/routelab;
    index index.html;

    # ⚠️ これだと /users/1 で404になる
    location / {
    }
}

有効にして、確かめます。

bash
$ sudo ln -s /etc/nginx/sites-available/routelab /etc/nginx/sites-enabled/routelab
$ sudo nginx -t
$ sudo systemctl reload nginx
$ sudo ufw allow 8190/tcp

確認: nginx -t が syntax is ok と test is successful を返してから reload します。-t を飛ばして reload すると、設定ミスで nginx ごと止まります。

ホストのブラウザで http://<VMのIP>:8190/users/1 を開きます。

→ nginx の 404 Not Found が出ます。 serve のときと同じです。サーバーが違っても、起きていることは同じだと分かります。

ログでも確かめます。

bash
$ sudo tail -n 5 /var/log/nginx/access.log

確認: "GET /users/1 HTTP/1.1" 404 の行が出ています。サーバーは、言われたとおりファイルを探して、無かったと答えているだけです。

では直します。設定ファイルの全文です。

bash
$ sudo nano /etc/nginx/sites-available/routelab
server {
    listen 8190;
    server_name _;

    root /var/www/routelab;
    index index.html;

    # SPA の要。
    # ① そのままのパスでファイルを探す
    # ② ディレクトリとして探す
    # ③ どちらも無ければ index.html を返す(404にしない)
    location / {
        try_files $uri $uri/ /index.html;
    }

    # ビルドで名前にハッシュが付くファイルは、長くキャッシュしてよい
    location /assets/ {
        expires 1y;
        add_header Cache-Control "public, immutable";
        try_files $uri =404;
    }

    # index.html はキャッシュさせない(更新が届かなくなるため)
    location = /index.html {
        add_header Cache-Control "no-store";
    }
}
bash
$ sudo nginx -t
$ sudo systemctl reload nginx

確認: もう一度 http://<VMのIP>:8190/users/1 を開きます。詳細画面が出れば直りました。 F5でも消えません。

bash
$ curl -s -o /dev/null -w '%{http_code}\n' http://localhost:8190/users/1

確認: 200 が返れば成功です。直す前にこれを打つと 404 です。 前後で1回ずつ打つと、何が変わったのかが数字で残ります。

📸 スクリーンショット指示: curl の結果が 404 → 200 に変わったところを、同じターミナル画面の中に2回分入れて撮ってください。

この直し方の副作用

try_files ... /index.html は強力ですが、代償があります。

起きること内容
本物の404が消える存在しないURLでも、HTTP 200 で index.html が返る。検索エンジンからは「全部あるページ」に見える
画像やCSSの打ち間違いが分からない/img/logo.png を打ち間違えても、HTMLが返ってくる。ブラウザは「画像が壊れている」としか言わない
APIのパスと衝突する同じサーバーで /api/ も出しているなら、/api/ を先に別の location で受ける必要がある

2番目が特に厄介です。だから上の設定では、/assets/ だけは try_files $uri =404; にして、無いものは正直に404を返すようにしています。ここを分けておかないと、「画像が出ない」の原因究明に半日溶かします。

1番目については、React Router 側の path="*" の画面が出るので、人には404だと伝わります。 ただしHTTPのステータスコードは200のままです。それが困る(検索エンジンに正しく伝えたい)なら、サーバー側でHTMLを返す作り=SSRの話になります(SSRとNext.jsの回)。

try_files は「SPAの回避策」であって「正解」ではありません。 URLに意味を持たせたいのに、サーバーはURLを1つしか知らない、というズレを埋めているだけです。


この症状は、配信するサーバーの設定を自分で触れる環境でないと、直し方まで試せません。さくらのVPSのような VPS を 1 台持っておくと、nginx の設定を自分で書いて壊し、直す練習が本番と同じ形でできます。512MB プランで月払い 643〜698 円(税込・リージョンで異なる、2026-11 時点)、クレジットカード払いなら 2 週間無料で試せますが、最低利用期間は 3 ヶ月です。

⑤ データをどこで取るか(ウォーターフォールを見る)

ルーティングが動いたので、次は中身です。詳細画面でユーザー情報を取ってきます。

まず、よくある書き方から。 画面が出てから useEffect で取ります。

src/App.jsx の UserDetail を、これに差し替えます(users の配列はそのまま残します)。

// 通信の遅さを再現するための、わざとゆっくりな取得
function fetchUser(id) {
  return new Promise((resolve) => {
    setTimeout(() => {
      resolve(users.find((u) => String(u.id) === String(id)) ?? null);
    }, 800);
  });
}

function fetchPosts(userId) {
  return new Promise((resolve) => {
    setTimeout(() => {
      resolve([`${userId}の記事A`, `${userId}の記事B`]);
    }, 800);
  });
}

function UserDetail() {
  const { id } = useParams();
  const [user, setUser] = useState(null);
  const [posts, setPosts] = useState(null);

  useEffect(() => {
    let alive = true;
    setUser(null);
    setPosts(null);
    fetchUser(id).then((u) => {
      if (!alive) return;
      setUser(u);
      // ⚠️ ユーザーが取れてから、記事を取りに行く
      fetchPosts(u.id).then((p) => alive && setPosts(p));
    });
    return () => { alive = false; };
  }, [id]);

  if (!user) return <p>読み込み中…</p>;

  return (
    <div>
      <h2>{user.name}</h2>
      <p>役割: {user.role}</p>
      {posts ? <ul>{posts.map((p) => <li key={p}>{p}</li>)}</ul> : <p>記事を読み込み中…</p>}
    </div>
  );
}

useState と useEffect の import を先頭に足すのを忘れずに。

import { useState, useEffect } from 'react';

一覧から名前をクリックしてください。 何が見えるか。

  1. クリックした瞬間に画面が切り替わる(ここは速い)
  2. 「読み込み中…」が 0.8秒
  3. 名前が出て、下に「記事を読み込み中…」が さらに0.8秒
  4. やっと全部揃う

合計1.6秒、レイアウトが2回ガタッと動きます。 これがウォーターフォールです。通信が遅いのではなく、待つ順番が直列なだけです。

📸 スクリーンショット指示: 「読み込み中…」の段階と、「記事を読み込み中…」の段階を2枚撮ってください。同じ画面がこの順で2回変わることが分かるように。

loader で「遷移する前に」取る

React Router には、ルートに紐づけてデータを取る仕組みがあります。Routes / Route の書き方ではなく、ルートをデータとして定義する形に変えます。

src/App.jsx の App と、ルート定義部分をこれに差し替えます。

import {
  createBrowserRouter,
  RouterProvider,
  Link,
  Outlet,
  useLoaderData,
} from 'react-router-dom';

function UserDetailWithLoader() {
  // すでに取れている状態でここに来る
  const { user, posts } = useLoaderData();

  return (
    <div>
      <h2>{user.name}</h2>
      <p>役割: {user.role}</p>
      <ul>{posts.map((p) => <li key={p}>{p}</li>)}</ul>
      <Link to="/users">一覧へ戻る</Link>
    </div>
  );
}

const router = createBrowserRouter([
  {
    path: '/',
    element: <Layout />,
    children: [
      { index: true, element: <Home /> },
      { path: 'about', element: <About /> },
      { path: 'users', element: <UserList /> },
      {
        path: 'users/:id',
        element: <UserDetailWithLoader />,
        loader: async ({ params }) => {
          // ⚠️ 2つ同時に投げる。直列にしない
          const [user, posts] = await Promise.all([
            fetchUser(params.id),
            fetchPosts(params.id),
          ]);
          return { user, posts };
        },
      },
      { path: '*', element: <NotFound /> },
    ],
  },
]);

export default function App() {
  return <RouterProvider router={router} />;
}

もう一度、一覧から名前をクリックします。

  • クリックしても、しばらく一覧のままです(0.8秒)
  • そのあと、詳細画面が最初から全部揃った状態で出ます
  • 「読み込み中…」が1回も出ません。レイアウトも動きません

合計1.6秒が0.8秒になりました。 速くなった理由は2つです。

理由内容
並列にしたPromise.all で2本同時に投げた。直列の1.6秒が、並列の0.8秒に
遷移前に取った「画面を出してから取る」ではなく「取れてから出す」。ガタつきが消えるのはこちらの効果

どちらが正しい、ではありません。 loader は「待たせてから、完成した画面を出す」。useEffect は「すぐ出して、あとから埋める」。 重い一覧を丸ごと待たせると「固まった」と思われます。 骨組みだけ先に出したい場面もあります。 大事なのは「取り始めるのが遅いせいで直列になっている」のを、選んだつもりでいないことです。

データ取得そのものの話は、取得のコードが200行になる回でやりました。ルーターの loader と、取得ライブラリのキャッシュは、競合ではなく組み合わせるものです。


⑥ TanStack Router で同じものを作る

もう1つの選択肢を、実際に触って比べます。 一番の違いは型なので、TypeScript で作ります(TypeScriptの回)。

bash
$ cd ~/routelab
$ npm create vite@latest tsr-app -- --template react-ts
$ cd tsr-app
$ npm install
$ npm install @tanstack/react-router
$ npm ls @tanstack/react-router

確認: バージョンが表示されればOKです。書き方はTanStack Router 公式で確認してください。

src/App.tsx を作ります。

bash
$ nano src/App.tsx
import {
  createRouter,
  createRoute,
  createRootRoute,
  RouterProvider,
  Link,
  Outlet,
} from '@tanstack/react-router';

const users = [
  { id: 1, name: 'sato', role: '管理者' },
  { id: 2, name: 'suzuki', role: '一般' },
  { id: 3, name: 'takahashi', role: '一般' },
];

const rootRoute = createRootRoute({
  component: () => (
    <div style={{ fontFamily: 'sans-serif', padding: 24 }}>
      <h1>routelab (TanStack)</h1>
      <nav style={{ display: 'flex', gap: 12, marginBottom: 16 }}>
        <Link to="/">トップ</Link>
        <Link to="/users">ユーザー</Link>
        <Link to="/about">About</Link>
      </nav>
      <hr />
      <Outlet />
    </div>
  ),
  notFoundComponent: () => <p>ページが見つかりません(404)</p>,
});

const indexRoute = createRoute({
  getParentRoute: () => rootRoute,
  path: '/',
  component: () => <p>トップページです。</p>,
});

const aboutRoute = createRoute({
  getParentRoute: () => rootRoute,
  path: '/about',
  component: () => <p>このサイトについて。</p>,
});

const usersRoute = createRoute({
  getParentRoute: () => rootRoute,
  path: '/users',
  component: () => (
    <ul>
      {users.map((u) => (
        <li key={u.id}>
          <Link to="/users/$id" params={{ id: String(u.id) }}>
            {u.name}
          </Link>
        </li>
      ))}
    </ul>
  ),
});

const userDetailRoute = createRoute({
  getParentRoute: () => rootRoute,
  path: '/users/$id',
  loader: ({ params }) => {
    const user = users.find((u) => String(u.id) === params.id);
    return { user };
  },
  component: function UserDetail() {
    // ⚠️ ここに型が付く。params.id は string で、id 以外は存在しない
    const { id } = userDetailRoute.useParams();
    const { user } = userDetailRoute.useLoaderData();

    if (!user) return <p>そのユーザーはいません(id: {id})</p>;

    return (
      <div>
        <h2>{user.name}</h2>
        <p>役割: {user.role}</p>
        <Link to="/users">一覧へ戻る</Link>
      </div>
    );
  },
});

const routeTree = rootRoute.addChildren([
  indexRoute,
  aboutRoute,
  usersRoute,
  userDetailRoute,
]);

const router = createRouter({ routeTree });

declare module '@tanstack/react-router' {
  interface Register {
    router: typeof router;
  }
}

export default function App() {
  return <RouterProvider router={router} />;
}

src/main.tsx から App を読むようにして、起動します。

bash
$ cd ~/routelab/tsr-app
$ npm run dev -- --host 0.0.0.0 --port 5192
$ sudo ufw allow 5192/tcp

確認: http://<VMのIP>:5192/ を開いて、同じ画面が出れば成功です。遷移も戻るボタンも、React Router と同じように動きます。

最大の違い: パスを間違えると、実行する前に落ちる

わざと壊します。 usersRoute のリンクを、存在しないパスに書き換えてください。

<Link to="/user/$id" params={{ id: String(u.id) }}>

users を user にしただけです。打ち間違いとして、いくらでも起こります。

保存すると、エディタが即座に赤線を引きます。 そして、ビルドすると落ちます。

bash
$ cd ~/routelab/tsr-app
$ npx tsc -p tsconfig.app.json --noEmit

確認: Type '"/user/$id"' is not assignable to type ... のようなエラーが出て、終了コードが0以外になります。

bash
$ echo $?

確認: 2 などが返れば、CIで確実に止められるということです。

同じ間違いを React Router 側でやると、どうなるか。

bash
$ cd ~/routelab/rr-app
$ # Link の to を "/user/1" に書き換えてから
$ npm run build

→ ビルドは成功します。 実行して、そのリンクを人がクリックして初めて、404の画面が出ます。

React RouterTanStack Router
存在しないパスへの Linkビルドは通る。 クリックして初めて分かるエディタで赤線、ビルドで停止
params の型string | undefined。綴りの間違いは気づけないそのルートに実在するパラメータだけ。型が付く
気づくタイミング実行時。最悪、公開後に利用者が踏む書いた瞬間

これが TanStack Router の売りです。速さや軽さではありません。 URLは文字列なので、普通は誰も検査してくれません。 それを型で守れるようにしたのが、このライブラリの一番の中身です。

ファイルベースのルート生成

上のように手でルートを並べるのは、画面が増えるとつらくなります。 TanStack Router には、src/routes/ の中のファイル構成からルートを自動生成するやり方があります。

  • src/routes/index.tsx → /
  • src/routes/about.tsx → /about
  • src/routes/users/index.tsx → /users
  • src/routes/users/$id.tsx → /users/:id

Vite のプラグイン(@tanstack/router-plugin)を入れると、ファイルを置いた瞬間に型付きのルートツリーが生成されます。 手順は公式のFile-Based Routingを見てください。

「ファイル配置=URL」は Next.js や Nuxt が広めた考え方で、ルート定義とファイルがズレなくなるのが利点です。手で書くルート定義は、必ずどこかでファイルと食い違います。

ただし、④の404問題は TanStack Router でも同じように起きます。 これはライブラリの問題ではなく配信の問題なので、try_files は同じように必要です。


⑦ 何を選ぶか、表で比べる

React RouterTanStack Routerフレームワーク内蔵(Next.js など)
立ち位置事実上の標準。 一番情報が多い新しい。型を最優先した設計ルーターがフレームワークの一部。選ぶ余地がない
型パスもparamsもただの文字列パス・params・検索文字列に型が付く実装による。近年は型付きが増えている
学習コスト低い。 Link と Route だけで始められるやや高い。 TypeScript前提で、最初の型定義でつまずく高い。 ルーターだけでなく、描画の仕組みごと覚える
日本語情報多い。 ただし古い書き方の記事が混ざる少ない。公式を英語で読む前提多い
検索文字列(?q=...)自分で URLSearchParams を扱うスキーマを書いて型で受け取れる(これが実は一番効く)実装による
データ取得loader ありloader あり。TanStack Query と組み合わせやすいフレームワーク側の仕組みに乗る
SPAの404問題起きる(try_files が要る)起きる(同上)起きない。サーバー側がURLを知っている
向いている規模小〜大。何でも。 既存プロジェクトなら基本これ中〜大。 画面とパラメータが多いほど型が効く中〜大。SEOや初期表示が要件なら最初からこちら

表の一番下から2行目が、実は一番大きい違いです。 Next.js のようなフレームワークでは、サーバーが /users/1 を知っているので、④の問題がそもそも起きません。「SPAで try_files を書く」は、サーバーにURLの知識が無いことへの埋め合わせです。


⑧ 判断: 3枚ならルーターを入れない

ここまで触ったうえでの結論です。

まず、入れないという選択肢を先に置きます。

画面が3枚で、URLで指す必要がないなら、ルーターは要りません。 ①の useState で十分です。管理画面のタブ、ウィザードの1〜3ステップ、モーダルの中身。これらにルーターを入れると、URLの設計という仕事が増えるだけです。

入れる理由は、画面の枚数ではありません。 こう聞いてください。

「この画面を、URLだけで人に見せられる必要があるか?」

答えがはいなら、入れます。「はい」になる条件は、実はかなり狭いです。

状況判断
画面3枚、ブックマークも共有もしない入れない。 useState で切り替える
一覧と詳細がある(/items/1 を送りたい)入れる。 ここが分かれ目
検索条件を共有したい(?q=react&page=2)入れる。 そして検索文字列の扱いが決め手になる
SEOや初期表示の速さが要件ルーターの選択ではなく、SSRの検討。SSRの回へ

入れると決めたあと、どちらか。

  • 既存のプロジェクト、チームに初学者がいる、情報量を優先する → React Router

詰まったときに日本語で答えが出てくることの価値は、実際に一人で作っていると想像よりずっと大きいです

  • 新規で、TypeScript を使っていて、画面とパラメータが多い → TanStack Router

「型で守れる」の実体は、Link のパスと params と検索文字列です。この3つを手で書き間違えた経験があるかどうかで、価値の感じ方が変わります

  • SEOと初期表示が要件に入っている → そもそもルーター単体の話ではない

Next.js などを検討してください。ルーターだけ差し替えても、try_files の問題は残ります

そして、どちらを選んでも変わらないこと。

④の404は、必ず起きます。 ライブラリの選択とは無関係です。本番に出す前に、必ず「詳細ページのURLを直接ブラウザに打ち込む」を1回やってください。それだけで、公開後に一番恥ずかしい壊れ方を防げます。


つまずいたところ

1. 「開発では動くのに」を、開発サーバーのバグだと思った。 逆でした。Vite の開発サーバーが、最初から try_files 相当のことをやってくれているだけです。親切なせいで、本番との差に気づけません。 いまは「開発で動いた」を根拠にしなくなりました。

2. try_files を書いたのに直らなかった。 nginx -t は通っているのに404のままでした。原因は、シンボリックリンクを張っただけで reload していなかったことです。nginx は設定ファイルを保存した瞬間には読み直しません。 sudo systemctl reload nginx を打つまで、古い設定で動き続けます。

3. 直ったあと、画像が全部出なくなった。 location / { try_files $uri $uri/ /index.html; } だけを書いていたので、存在しない画像のパスにHTMLが返っていました。 ブラウザは「壊れた画像」としか言わず、Networkタブを見るまで200が返っていることに気づけませんでした。/assets/ に try_files $uri =404; を足してからは、Networkタブに素直に404が出るようになりました。

4. Link を使わずに <a href> で書いていた。 半分くらいのリンクが <a> のままでした。押すと画面は正しく出るので、ずっと気づきませんでした。 「なんかこのリンクだけ一瞬白くなる」で気づきました。 ページを丸ごと読み込み直していたので、当然です。

5. useParams の名前を間違えた。 <Route path=":userId" /> に対して const { id } = useParams() と書いていました。id は undefined になりますが、エラーは出ません。 「データが見つかりません」と画面に出るので、取得側を疑って30分溶かしました。 ⑥で TanStack Router の型を見たとき、これが止まるのかと思いました。

6. loader に変えたら「押しても何も起きない」と言われた。 0.8秒待ってから画面が出るので、押した直後に反応が無いのです。useEffect のガタつきを消したら、今度は「固まった」と言われました。 遷移中であることを示す表示(useNavigation などの仕組み)が要る、というのを指摘されるまで考えていませんでした。

7. TanStack Router の最初の型定義でつまずいた。 declare module '@tanstack/react-router' の Register を書かないと、Link の型補完がまったく効きません。 「型が売りのはずなのに型が付かない」で1時間でした。このライブラリは、型を動かすための儀式が最初に1回あると分かってからは素直でした。

8. 古い記事のコードをそのまま貼って動かなかった。 React Router は、Switch → Routes → createBrowserRouter と書き方が何度も変わっています。 検索で出てくる日本語記事は、どのバージョンの話か書いていないことが多いです。npm ls react-router-dom でバージョンを確かめてから、そのバージョンの公式を読む、に切り替えました。


後片づけ

開発サーバーを止めます。 起動しているターミナルで Ctrl+C を押してください。

bash
$ ps aux | grep -c '[v]ite'

確認: 0 なら止まっています。

nginx の設定を外します。

bash
$ sudo rm /etc/nginx/sites-enabled/routelab
$ sudo rm /etc/nginx/sites-available/routelab
$ sudo nginx -t
$ sudo systemctl reload nginx

確認: nginx -t が successful を返してから reload します。sites-enabled のリンクだけ消して reload を忘れると、設定は生きたままです。

配信していたファイルを消します。

bash
$ sudo rm -rf /var/www/routelab
$ ls /var/www

確認: routelab が消えていること。/var/www/html は消さないでください。 nginx の既定のサイトが動かなくなります。

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

bash
$ sudo ufw delete allow 5190/tcp
$ sudo ufw delete allow 5191/tcp
$ sudo ufw delete allow 5192/tcp
$ sudo ufw delete allow 8190/tcp
$ sudo ufw status

確認: 一覧に 5190 5191 5192 8190 が1つも残っていなければ成功です。

プロジェクトを消します。

bash
$ du -sh ~/routelab
$ rm -rf ~/routelab
$ ls ~

確認: routelab が消えていれば片づけ完了です。

本線のものが無事なことを確認します。

bash
$ ls ~/react-demo/src

~/react-demo/ は、この先の本線でも使うので消さないでください。

戻し方: もう一度やりたくなったら、①の npm create vite@latest からやり直すだけです。数分で戻せます。 node_modules だけ消して中身を残すなら rm -rf ~/routelab/rr-app/node_modules、戻すのは cd ~/routelab/rr-app && npm install です(npmの回)。


まとめ — 理解できたこと

  • 「リロードで戻る・URLを共有できない・戻るボタンが効かない」は、3つの別の不具合ではない。 URLを更新していない、という1つの原因の3つの見え方
  • 状態はReactが持ち、URLはブラウザが持つ。 ルーターとは、この2つを常に一致させ続ける仕組みであって、「画面を切り替える道具」ではない
  • ルーターの正体は history.pushState と popstate の薄い皮。 Reactの機能ですらなく、ブラウザに前からある機能を宣言的に書けるようにしただけ
  • その3行は自分でも書ける。 ライブラリを入れる理由は「楽だから」ではなく、動的パス・ネスト・404・スクロール復元まで自分で書くと確実にバグらせるから
  • <a href> はページ全体を捨てて読み込み直す。 見た目は同じ画面に着くので気づかない。 Networkタブで一目で分かる
  • Link は <a> を描いたうえで既定の動作を止め、pushState を呼んでいるだけ。 外部サイトへのリンクは <a> のままが正しい
  • ビルドして配信すると、/users/1 を直接開いた瞬間に404になる。 サーバーは /users/1 という名前のファイルを本気で探しに行くから
  • サーバーはルート定義を1文字も知らない。 ルート定義はJSの中にあり、そのJSはHTMLが返ってからしか動かない。だから「開発では動くのに」が起きる
  • 直し方は try_files $uri $uri/ /index.html;。 「無かったら index.html を返せ」と1つ教えるだけ
  • try_files は正解ではなく回避策。 本物の404が消え、HTTP 200 で「無いページ」が返るようになる
  • /assets/ だけは try_files $uri =404; にしておく。 これを分けないと、画像の打ち間違いにHTMLが返り、原因究明に半日溶かす
  • 画面を出してから useEffect で取ると、待ち時間が直列に積み上がる。 通信が遅いのではなく、取り始める順番が遅い
  • loader は遷移する前に取る。 並列化で半分になり、ガタつきが消えるのは「取れてから出す」ほうの効果
  • ただし loader は「押しても何も起きない」時間を作る。 遷移中であることを見せる表示が別に要る
  • TanStack Router の売りは速さでも軽さでもなく「型」。 URLは文字列なので普通は誰も検査してくれない、そこを守る
  • 存在しないパスへの Link が tsc で落ちる。 React Router では同じ間違いがビルドを通り、人がクリックして初めて404になる
  • params にも型が付く。 React Router の params.id は常に string \| undefined で、:userId と id の食い違いを誰も止めない
  • 型を動かすには declare module の Register を最初に1回書く必要がある。 書かないと「型が売りなのに型が付かない」になる
  • ファイル配置=URLの自動生成は、ルート定義とファイルのズレを無くすためのもの。 手で書いたルート定義は、必ずどこかでファイルと食い違う
  • ④の404は、どのルーターを選んでも起きる。 配信の問題であってライブラリの問題ではない
  • フレームワーク内蔵のルーターでは起きない。 サーバー側がURLを知っているからで、try_files はその知識が無いことへの埋め合わせ
  • 画面が3枚でURLで指す必要が無いなら、ルーターは入れない。 入れる基準は枚数ではなく「URLだけで人に見せられる必要があるか」
  • 既存プロジェクト・情報量優先なら React Router、型で守りたい新規なら TanStack Router。 一人で作っていると、日本語で答えが出てくる価値は想像よりずっと大きい
  • React Router は書き方が何度も変わっている。 npm ls でバージョンを確かめてから、そのバージョンの公式を読む
  • 本番に出す前に、詳細ページのURLを直接ブラウザに打ち込む。 これ1回で、公開後に一番恥ずかしい壊れ方を防げる

参考リンク


次に読む

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

記事
← 前の記事ReactとTypeScript — anyを1つで型検査が消える
→ 次の記事SSRとSSGのフレームワーク — SNSに貼るとタイトルが出ない

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

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

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

›React — Routing
  • History API の薄い皮がルーター
  • 本番で直リンクが404になる理由

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

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

コメント

コメントする

目次