Prerenderは何を優先したのか:ビルド時に全URLを確定させるという価値選択

著者: ClaudeMix Team |

React Router v7のprerender機能は、ビルド時に全URLを確定させ、リクエスト時の処理をゼロにすることを優先している。

① Prerenderは何を優先したか

一般的なフルスタックフレームワークの実装では、loader はリクエストごとにサーバーで実行される。Markdown記事の配信であっても、内容が変わっていなくても、リクエストのたびにサーバーがMarkdownをHTMLへ変換し直す。

React Router v7の prerender オプションは、この「リクエストごとに処理する」という前提を疑う。ビルド時に対象URLを全て確定させ、それぞれのルートをビルド時に一度だけ実行して静的HTMLを生成する。

  • 【優先した価値】: ビルド時にURLの存在とコンテンツを確定させる、配信の確実性。静的ファイルはCDNエッジが直接返すため、Workerの起動もコールドスタートも発生しない
  • 【犠牲にした価値】: リアルタイム性。記事を更新しても、再ビルド・再デプロイをしない限りコンテンツは反映されない。Cookieや認証状態に基づくリクエスト時の出し分けもできなくなる

② ClaudeMixでやったこと

Before: ブログ記事はSSRルートとして配信していた。loader がリクエストごとに content/blog/posts/ からMarkdownを読み、その場でHTMLへ変換していた。ビルド設定には prerender の指定がなく、全ルートが実行時処理の対象だった。

// react-router.config.ts(変更前)
export default {
  ssr: true,
};

After: prerender 関数を追加し、content/blog/posts/ を走査して全スラッグのURLを返すようにした。ビルド時にViteプラグインがこれらのURLに対して loader を実行し、静的HTMLを生成する。

// react-router.config.ts(変更後)
import { readdir } from 'node:fs/promises';
import { join } from 'node:path';

async function getBlogSlugs(): Promise<string[]> {
  const contentDir = join(process.cwd(), 'content/blog/posts');
  const files = await readdir(contentDir);
  return files
    .filter(f => f.endsWith('.md'))
    .map(f => f.replace(/\.md$/, ''));
}

export default {
  ssr: true,
  prerender: async () => {
    const slugs = await getBlogSlugs();
    return ['/blog', ...slugs.map(s => `/blog/${s}`)];
  },
};

loader 関数自体は変更していない。変わったのは「このルートをいつ実行するか(リクエスト時かビルド時か)」という設定だけだった。

③ 技術的負債

  • 【新たに生まれた負債】: Viteはプリレンダリング後のHTMLを build/client/blog/{slug}/index.html というディレクトリ構造で出力する。Cloudflare Pagesはこの構造に対し、/blog/{slug} へのアクセスを /blog/{slug}/ へ308リダイレクトする。SSR配信時には存在しなかった問題で、プリレンダリング導入によって新たに発生した。この308リダイレクトによりLCPが最大750ms増加し、PageSpeed InsightsのPerformanceスコアは74点まで低下した。
  • 【解消した負債】: public/_redirects にCloudflare Pagesの200 rewriteルールを追加し、ブラウザへのリダイレクトではなくエッジ上での内部書き換えとして処理させた。実測: 74点 → 98点
# public/_redirects
/blog   /blog/  200
/blog/:slug /blog/:slug/  200

④ 経営翻訳

新設した受付窓口への案内表示を設置した直後、来訪者が一旦別の窓口へ誘導されてからようやく正しい窓口にたどり着くという遠回りが発生していた。案内表示の設定を直接修正し、最初から正しい窓口へ案内するようにした。

実際には案内完了スコアが74点から98点まで改善し、32%の向上となった。遠回りをなくす案内表示の修正が効いた。

新設した受付窓口への案内表示を設置した直後、来訪者が一旦別の窓口へ誘導されてから ようやく正しい窓口にたどり着くという遠回りが発生していた。 案内表示の設定を直接修正することにした。

来訪者の案内完了スコア: 74点