※本記事はアフィリエイト広告(PR)を含みます。
リロードすると最初の画面に戻るのは、サーバーがそのURLを知らないからです。ルーティングの仕組みをサーバー設定まで降りて見ます。
これは【深掘り】の記事です。本線の順路ではありません。 本線のルーティングの回で「/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で指せる必要があるか」
この記事でやること
~/routelab/を新しく作り、素のReactで3つの症状(リロード・共有・戻る)を実際に出すhistory.pushStateとpopstateを素で書いて、ルーター無しでURLを合わせる- React Router を入れて、
Link/ 動的セグメント / ネストとOutlet/ 404ルートまで作る - ビルドして 8190番で配信し、
/users/1を直接開いて404を再現する。nginxの設定ファイルの全文を出して直す useEffectで取る形とloaderで取る形を並べて、ローディングの出方を比べる- 同じ画面を TanStack Router(TypeScript)で作り直し、存在しないパスへの
Linkがビルドで落ちるところを出す - 表で比べて、何を選ぶかを決める
先に知る言葉
基本的な言葉は用語集にもまとめてあります。
| 言葉 | 意味 |
|---|---|
| SPA | Single Page Application。最初に1枚のHTMLだけ読み込み、あとはJavaScriptが中身を書き換え続ける作り |
| ルーティング | URLと、画面に出すものの対応を決めること。「/users/1 ならユーザー詳細」 |
| History API | ブラウザが前から持っている、アドレスバーと履歴を書き換える機能。pushState など |
pushState | ページを読み込み直さずに、URLと履歴を1つ進める命令。ルーターの心臓部 |
popstate | 戻る・進むが押されたときに起きるイベント。これを拾わないと戻るボタンが効かない |
| 動的セグメント | /users/:id の :id の部分。URLの一部を値として受け取る書き方 |
| ネストルート | 画面の一部だけを差し替える入れ子構造。共通のヘッダを残したまま中身を変える |
Outlet | ネストしたとき、子の画面がここに入るという差し込み口 |
try_files | nginx の設定。ファイルを順に探して、無ければ最後のものを返す |
| ウォーターフォール | 通信が滝のように直列に並ぶこと。1つ終わってから次が始まるので、待ち時間が足し算になる |
① 症状を3つとも自分で出す
まず、ルーター無しのアプリを作ります。 ここを飛ばすと、あとの話が「そういうものらしい」で終わります。
質問が出たら、そのままEnterで進めて構いません。作られたものを、この記事用のフォルダに移します。
確認: ls して src と package.json が見えれば成功です。
vite の開発サーバーは、既定ではVMの中からしか見えません。 ホストのWindowsのブラウザで開くので、外から見えるようにします。
別のターミナルを開いて、ポートを通します。
確認: 5190/tcp ALLOW が一覧に出れば通っています。VMのIPは ip a で確認してください。ホストのブラウザで http://<VMのIP>:5190/ を開いて、Viteの初期画面が出れば準備完了です。
では、ルーター無しの「切り替え」を書きます。
中身を全部消して、これに置き換えます。
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 を、もう一度全部置き換えます。
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 を入れる
一番使われているものから入れます。
確認: react-router-dom@7.x.x のようにバージョンが表示されれば入っています。このあとの書き方は、いま入ったバージョンのドキュメント(React Router 公式)で必ず確認してください。Reactのルーターは書き方が何度も変わっている領域で、古い記事のコードがそのまま動かないことがよくあります。
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"> を混ぜてあります。 これを見るために、ブラウザの開発者ツールを開きます(開発者ツールの回)。
- F12 を押して、Network タブを開く
- 左上の 🚫(クリア) を押して、いったん空にする
Linkの「About」を押す → 通信が1本も増えません(あるいはデータ取得だけ)- もう一度クリアして、「About(素のa)」を押す →
aboutというドキュメントの取得が走り、その下にJSとCSSがぶら下がります
📸 スクリーンショット指示: Networkタブを2枚。
Linkを押したあと(ほぼ空)と、<a>を押したあと(ドキュメント+JS+CSSが並ぶ)を並べて撮ってください。
これがSPAで一番よくある「なぜか遅い」の正体です。 <a href> はブラウザの標準の動きで、ページ全体を捨てて読み込み直します。 アプリの状態は全部消え、JavaScriptも再実行されます。見た目は同じ画面に着くので、気づきません。
Link は、内部で <a> を描いたうえで、クリックの既定の動作を止めて pushState を呼んでいるだけです。②で自分の手で書いたものと、やっていることは同じです。
外部サイトへのリンクは
<a>のままで正解です。 アプリの中の移動だけLinkにします。
④ ビルドすると /users/1 が404になる
ここがこの記事の本題です。 開発サーバーでは全部動いています。そのまま本番に出すと、ほぼ確実に踏みます。
まずビルドします。
確認: dist/index.html と dist/assets/ ができています。HTMLは index.html の1枚しかありません。 ここが伏線です(ビルドツールの回)。
dist を、普通の静的ファイル配信で出してみます。まずは手軽なほうから。
別のターミナルでポートを通します。
ホストのブラウザで http://<VMのIP>:5191/ を開きます。
- トップは出ます
Linkで/users/1まで進めます。 ここまでは正常です- その状態で F5 を押してください。
→ 404 です。
アドレスバーに http://<VMのIP>:5191/users/1 と直接打ち込んでも、同じく404です。人に送ったURLも、全部これになります。
なぜか。 順番に考えます。
- ブラウザはサーバーに
GET /users/1を送る - サーバーは「
/users/1というファイル」を探す distの中にはindex.htmlとassets/しかない- 見つからないので 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つのオプションで済みます。
-s は single(SPAモード)です。もう一度 /users/1 を直接開いてください。 今度は出ます。
確認: F5でも、アドレスバーへの直接入力でも、詳細画面が出れば直っています。
nginx でやる(本番はこちら)
serve は開発用の道具です。本番は nginx で配信します(nginxの回)。
まず、ビルド結果を置く場所を作ってコピーします。
確認: index.html と assets が見えればOKです。
設定ファイルを新しく作ります。 既存の設定は触りません。
「先頭に足してください」ではなく、このファイルの全文です。 中身を全部これにしてください。
まず、わざと壊れている(直す前の)状態から始めます。
server {
listen 8190;
server_name _;
root /var/www/routelab;
index index.html;
# ⚠️ これだと /users/1 で404になる
location / {
}
}
有効にして、確かめます。
確認: nginx -t が syntax is ok と test is successful を返してから reload します。-t を飛ばして reload すると、設定ミスで nginx ごと止まります。
ホストのブラウザで http://<VMのIP>:8190/users/1 を開きます。
→ nginx の 404 Not Found が出ます。 serve のときと同じです。サーバーが違っても、起きていることは同じだと分かります。
ログでも確かめます。
確認: "GET /users/1 HTTP/1.1" 404 の行が出ています。サーバーは、言われたとおりファイルを探して、無かったと答えているだけです。
では直します。設定ファイルの全文です。
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";
}
}
確認: もう一度 http://<VMのIP>:8190/users/1 を開きます。詳細画面が出れば直りました。 F5でも消えません。
確認: 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';
一覧から名前をクリックしてください。 何が見えるか。
- クリックした瞬間に画面が切り替わる(ここは速い)
- 「読み込み中…」が 0.8秒
- 名前が出て、下に「記事を読み込み中…」が さらに0.8秒
- やっと全部揃う
合計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の回)。
確認: バージョンが表示されればOKです。書き方はTanStack Router 公式で確認してください。
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 を読むようにして、起動します。
確認: http://<VMのIP>:5192/ を開いて、同じ画面が出れば成功です。遷移も戻るボタンも、React Router と同じように動きます。
最大の違い: パスを間違えると、実行する前に落ちる
わざと壊します。 usersRoute のリンクを、存在しないパスに書き換えてください。
<Link to="/user/$id" params={{ id: String(u.id) }}>
users を user にしただけです。打ち間違いとして、いくらでも起こります。
保存すると、エディタが即座に赤線を引きます。 そして、ビルドすると落ちます。
確認: Type '"/user/$id"' is not assignable to type ... のようなエラーが出て、終了コードが0以外になります。
確認: 2 などが返れば、CIで確実に止められるということです。
同じ間違いを React Router 側でやると、どうなるか。
→ ビルドは成功します。 実行して、そのリンクを人がクリックして初めて、404の画面が出ます。
| React Router | TanStack Router | |
|---|---|---|
存在しないパスへの Link | ビルドは通る。 クリックして初めて分かる | エディタで赤線、ビルドで停止 |
params の型 | string | undefined。綴りの間違いは気づけない | そのルートに実在するパラメータだけ。型が付く |
| 気づくタイミング | 実行時。最悪、公開後に利用者が踏む | 書いた瞬間 |
これが TanStack Router の売りです。速さや軽さではありません。 URLは文字列なので、普通は誰も検査してくれません。 それを型で守れるようにしたのが、このライブラリの一番の中身です。
ファイルベースのルート生成
上のように手でルートを並べるのは、画面が増えるとつらくなります。 TanStack Router には、src/routes/ の中のファイル構成からルートを自動生成するやり方があります。
src/routes/index.tsx→/src/routes/about.tsx→/aboutsrc/routes/users/index.tsx→/userssrc/routes/users/$id.tsx→/users/:id
Vite のプラグイン(@tanstack/router-plugin)を入れると、ファイルを置いた瞬間に型付きのルートツリーが生成されます。 手順は公式のFile-Based Routingを見てください。
「ファイル配置=URL」は Next.js や Nuxt が広めた考え方で、ルート定義とファイルがズレなくなるのが利点です。手で書くルート定義は、必ずどこかでファイルと食い違います。
ただし、④の404問題は TanStack Router でも同じように起きます。 これはライブラリの問題ではなく配信の問題なので、
try_filesは同じように必要です。
⑦ 何を選ぶか、表で比べる
| React Router | TanStack 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 を押してください。
確認: 0 なら止まっています。
nginx の設定を外します。
確認: nginx -t が successful を返してから reload します。sites-enabled のリンクだけ消して reload を忘れると、設定は生きたままです。
配信していたファイルを消します。
確認: routelab が消えていること。/var/www/html は消さないでください。 nginx の既定のサイトが動かなくなります。
開けたポートを全部閉じます。
確認: 一覧に 5190 5191 5192 8190 が1つも残っていなければ成功です。
プロジェクトを消します。
確認: routelab が消えていれば片づけ完了です。
本線のものが無事なことを確認します。
~/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回で、公開後に一番恥ずかしい壊れ方を防げる
参考リンク
- roadmap.sh — React
- roadmap.sh — Frontend
- React Router 公式
- TanStack Router 公式
- TanStack Router — File-Based Routing
- React 公式ドキュメント
- MDN — History API
- MDN — history.pushState
- MDN — popstate イベント
- MDN — URLSearchParams
- nginx 公式 — try_files
- nginx 公式 — 設定ファイルの構造
- Vite 公式ドキュメント
次に読む
この記事は 【深掘り】React の 20 / 24 本目です。
上から順に読めば積み上がるように並べています。 飛ばしても構いませんが、詰まったら前の回に戻ってください。
全体の順路は はじめに にあります。
roadmap.sh のどこをやっているか
- History API の薄い皮がルーター
- 本番で直リンクが404になる理由
この記事は、上の項目を実際に手を動かして確かめる回です。

コメント