🏛️

Next.js vs React Router:思想の根本的な違いを理解する

に公開

フレームワークを選ぶとき、機能比較だけでなく「思想」を理解することが重要です。本記事では、Next.jsとReact Routerの設計思想の違いを掘り下げ、プロジェクトに適した選択ができるようになることを目指します。

TL;DR

観点 Next.js React Router
思想の源流 PHP(ファイル = ページ = URL) Ember.js(URL = UIの状態)
ルーティング ファイルシステムが真実(規約ベース) コードが真実(明示的定義)
レイアウト 暗黙的な継承(layout.tsxを置くだけ) 明示的なネスト(Outlet指定)
データフェッチ RSC + Server Actions loader / action(Web標準寄り)
デプロイ Vercel最適化(他も可能だが追加設定あり) 環境非依存(Cloudflare, Node, Denoなど)
プログレッシブエンハンスメント Server Actionsで対応 コア思想として組み込み

思想の源流

Next.js:PHPの哲学を継承

Next.jsの創設者Guillermo Rauch(Vercel CEO)は、2017年にNext.jsを発表した際、「PHPとJavaScriptを融合させたフレームワーク」を目指したと述べています。

PHPでは、ファイルを作成してサーバーに置けば、そのままURLとしてアクセスできます。about.phpを作れば/aboutでアクセスできる。この「ファイル = ページ = URL」という直感的な対応関係がNext.jsの根底にあります。

app/
├── page.tsx           → /
├── about/
│   └── page.tsx       → /about
├── users/
│   └── [id]/
│       └── page.tsx   → /users/:id

特徴: 規約に従えばルーティングを考えなくていい。設定より規約(Convention over Configuration)。

React Router:Ember.jsの思想を継承

React Routerは、Ryan FlorenceとMichael Jacksonによって開発されました。彼らはEmber.jsのルーターに影響を受け、それをReact向けに再設計しました。

Ember.jsのルーティングは「URLはアプリケーションの状態である」という考えに基づいています。URLが変わればUIの状態が変わり、UIの状態が変わればURLも変わる。この双方向の関係がReact Routerの核心です。

// 明示的に「このURLはこのコンポーネント」と宣言
export default [
  index("routes/_index.tsx"),
  route("about", "routes/about.tsx"),
  route("users/:id", "routes/user.tsx"),
];

特徴: コードで明示的に書くから意図が明確。ファイル名とURLは独立しており、自由に決められる。

ルーティングの考え方

Next.js:ファイルシステムが真実

Next.jsでは、appディレクトリの構造がそのままURLになります。

  • ファイルを置けばルートができる
  • フォルダ構造 = URL構造
  • 設定ファイル不要
app/
├── blog/
│   ├── page.tsx           → /blog
│   └── [slug]/
│       └── page.tsx       → /blog/:slug

React Router:コードが真実

React Routerでは、ルートは明示的にコードで定義します。

import { type RouteConfig, route, index } from "@react-router/dev/routes";

export default [
  index("routes/_index.tsx"),
  route("blog", "routes/blog.tsx"),
  route("blog/:slug", "routes/blog-post.tsx"),
] satisfies RouteConfig;

違いの意味: Next.jsではファイル名がURLを決定しますが、React Routerではファイル名とURLは独立しています。blog-post.tsxというファイルが/blog/:slugというURLを担当する、という対応を自分で決められます。

レイアウトの扱い

Next.js:暗黙的な継承

app/
├── layout.tsx          ← 全ページに適用(自動)
├── dashboard/
│   ├── layout.tsx      ← dashboard配下に適用(自動)
│   └── page.tsx

layout.tsxを置くだけで、その配下のすべてのページに自動適用されます。親のレイアウトは自動で継承されるため、何が適用されているかはファイル構造を見ないとわかりません。

React Router:明示的なネスト

<Route element={<RootLayout />}>
  <Route path="dashboard" element={<DashboardLayout />}>
    <Route index element={<DashboardHome />} />
  </Route>
</Route>

ネスト構造がコードで見えるため、どのレイアウトがどのルートに適用されているかが一目瞭然です。<Outlet />で子コンポーネントを配置する場所を明示的に指定します。

データフェッチの思想

Next.js:サーバーファースト(React Server Components)

// Server Component(デフォルト)
async function UserPage({ params }) {
  // サーバーで実行、クライアントにはHTMLだけ送る
  const user = await db.user.findUnique({ 
    where: { id: params.id } 
  });
  
  return <div>{user.name}</div>;
}
  • コンポーネント自体がサーバーで実行される
  • asyncコンポーネントが書ける
  • RSC Payload(React Server Component Payload)という特殊なフォーマットでクライアントに送信
  • 思想: 「サーバーでできることはサーバーで」

React Router:Web標準寄り(loader / action)

// loader = GET時のデータ取得
export async function loader({ params }) {
  return await db.user.findUnique({ where: { id: params.id } });
}

// action = POST/PUT/DELETE時の処理
export async function action({ request }) {
  const formData = await request.formData();
  return await db.user.update({ ... });
}

// コンポーネントはデータを「使う」だけ
export default function UserPage() {
  const user = useLoaderData();
  return <div>{user.name}</div>;
}
  • データ取得とUIが分離
  • Request/Response/FormDataなどWeb標準API
  • 思想: 「HTMLフォームの延長線上」

プログレッシブエンハンスメント

React Router(およびその前身であるRemix)は、プログレッシブエンハンスメントをコア思想として持っています。

プログレッシブ・エンハンスメントとは、ウェブデザインにおける戦略であり、ウェブコンテンツを最優先に置くことで、誰もがウェブページの基本的なコンテンツと機能にアクセスできるようにするものです。(筆者訳)
— React Router公式ドキュメント

// このフォームはJavaScriptなしでも動く
<Form method="post" action="/add-to-cart">
  <input type="hidden" name="id" value={id} />
  <button type="submit">Add To Cart</button>
</Form>
  • JavaScriptが動く → クライアントサイドで処理、画面遷移なし
  • JavaScriptが動かない → 従来のフォーム送信、ページリロード

どちらでも動く。これがReact Routerの哲学です。

Next.jsもServer Actionsによってプログレッシブエンハンスメントをサポートしていますが、React Routerほど中心的な思想ではありません。

https://developer.mozilla.org/ja/docs/Glossary/Progressive_Enhancement

デプロイ環境

Next.js

Next.jsはVercelで最も最適化されて動作します。他のプラットフォームでも動作しますが、追加の設定が必要になることがあります。

主要なクラウドベンダーはすべてNext.jsのデプロイオプションを提供しています。Netlify、Cloudflare、AWS Amplify、Google Cloud、AzureはいずれもネイティブでNext.jsをサポートしています。(筆者訳)
— Vercel公式ブログ

一方で、以下のような指摘もあります。

Next.js 13以降では、Vercelのデプロイモデルを前提とした積極的なキャッシュ処理が実装されています。この前提は代替プラットフォームでは破綻し、パフォーマンスの低下や正確性の問題を引き起こす可能性があります。

React Router

React Router v7はCloudflare、Node.js、Deno、Bunなど、あらゆる環境で動作するように設計されています。

React Router v7 は、Webアプリケーション構築のためのフルスタック React フレームワークです。Cloudflare Vite プラグインと連携することで、Cloudflare 上でのアプリ開発、ビルド、デプロイに最適な環境を提供します。(筆者訳)
— Cloudflare公式ドキュメント

React Router v7とRemixの統合

2024年、RemixはReact Router v7として統合されました。

当初Remix v3としてリリース予定だったものは、React Router v7としてリリースされることになりました。(筆者訳)
— Remix公式ブログ

これにより、React Routerは単なるクライアントサイドルーティングライブラリから、フルスタックフレームワークへと進化しました。loader/action、プログレッシブエンハンスメント、サーバーサイドレンダリングなど、Remixの機能がすべてReact Router v7に含まれています。

どちらを選ぶべきか

Next.jsが向いているケース

  • Vercelにデプロイする予定
  • 大規模チームで規約による統一が必要
  • React Server Componentsをフル活用したい
  • ISR(Incremental Static Regeneration)が必要

React Routerが向いているケース

  • Cloudflare Pages/Workersにデプロイしたい
  • 小〜中規模チームで柔軟性を重視
  • Web標準に近いAPIを好む
  • 明示的なコントロールを好む

実体験:フレームワークの規約に逆らうと複雑になる

筆者は最近、React Router v7プロジェクトでNext.js App Routerの規約(page.tsx、[id]フォルダ)を自作スクリプトで再現しようとしました。

結果として...

  • 70行の自作ルーティングロジックが必要になった
  • Next.jsの規約とReact Routerの規約、両方を理解する必要があった
  • デバッグ時に自作コードも疑う必要があった

教訓: フレームワークの思想に乗ることが、長期的には最もシンプルな選択になる。

まとめ

Next.jsとReact Routerは、どちらも優れたフレームワークですが、その思想は根本的に異なります。

  • Next.js: 「規約に従えば考えなくていい」— PHPの哲学
  • React Router: 「明示的に書くから意図が明確」— Ember.jsの思想

どちらが「正しい」というわけではありません。プロジェクトの要件、チームの好み、デプロイ環境に合わせて選択してください。

重要なのは、選んだフレームワークの思想を理解し、それに乗ること。規約に逆らって独自の仕組みを作ると、両方の複雑さを抱えることになります。

参考リンク

Discussion