開発2024年8月22日8 分で読める#nextjs#architecture#performance

Next.js で耐障害性の高いシステムを構築する

モダンな Web アプリケーションにおける高可用性と高パフォーマンスのベストプラクティス。

TL;DR5
  1. ツールより先にアーキテクチャ:耐障害性は設計上の性質
  2. stale-while-revalidate 付きの ISR がバックエンド障害時もページを守る
  3. リトライにはバックオフとジッター — サーキットブレーカーが連鎖障害を断つ
  4. Error Boundary が障害をウィジェット単位に閉じ込める
  5. フォールバック UI とオフライン耐性はパッチではなくファーストクラスの機能
Next.js で耐障害性の高いシステムを構築する

アーキテクチャが先

Next.js はモダンな Web アプリケーションのバックボーンとして機能することが多い。耐障害性を確保するには、優れたアーキテクチャ上の決断と適切なツールの組み合わせが必要だ。

Server Components と適切な Error Boundary を活用すれば、完全にクラッシュするのではなく、グレースフルに劣化する極めて耐障害性の高い Web アプリを構築できる。

静的生成 vs SSR

可能な限り Incremental Static Regeneration(ISR)をデフォルトにする。これにより、バックエンド API が一時的に落ちても、最後にビルドに成功したバージョンをユーザーに届け続けられる。

ただしトレードオフは実在する。ISR は新鮮さを犠牲にして耐障害性を得る。SSR は新鮮さを得る代わりにバックエンドへの強い依存を抱える。

// app/blog/[slug]/page.tsx
export const revalidate = 300; // 5 分

export default async function Post({ params }) {
  const post = await fetchPost(params.slug); // キャッシュ + 再検証
  return <Article post={post} />;
}

昨年 Cloudflare の障害でオリジン API が 40 分間ダウンしたとき、y7.hk の ISR ページはすべて古いが有効な HTML を返し続けた。同じサイトの SSR ページは 500 を返していた。この実験で月間トラフィックの 4% を失い、レンダリング戦略の考え方が永久に変わった。

経験則: 5〜60 分の古さを許容できるコンテンツ(ブログ記事、製品ページ、マーケティング)は ISR。古さが製品を壊す場合のみ SSR(ライブダッシュボード、認証状態、リアルタイムデータ)。

Error Boundary は隔壁

Boundary がなければ、1 つのウィジェットの障害がページ全体を沈める。Boundary があれば各セクションが独立して失敗する。

// app/components/Section.tsx
'use client';
import { Component, ReactNode } from 'react';

export class Section extends Component<
  { children: ReactNode; fallback?: ReactNode },
  { hasError: boolean }
> {
  state = { hasError: false };

  static getDerivedStateFromError() {
    return { hasError: true };
  }

  render() {
    if (this.state.hasError) {
      return this.props.fallback ?? <div className="opacity-50">このセクションは利用できません</div>;
    }
    return this.props.children;
  }
}

サイドバーウィジェット、コメント欄、分析パネルなど、独立した単位すべてを個別の Boundary で包む。ユーザーは空白画面ではなく、ウィジェットがあった場所にグレーのボックスを見る。

Web3 ダッシュボードで一度の RPC タイムアウトがポートフォリオ全体をクラッシュさせた苦い経験がある。価格ティッカーを囲む Boundary が 1 つあればセッションは救えたはずだ。

リトライにはバックオフが必要

闇雲なリトライは障害を増幅する。指数バックオフ + ジッターが負荷を分散し、上流に回復時間を与える。

async function fetchWithRetry<T>(
  fn: () => Promise<T>,
  attempts = 3,
  baseDelay = 300
): Promise<T> {
  for (let i = 0; i < attempts; i++) {
    try {
      return await fn();
    } catch (err) {
      if (i === attempts - 1) throw err;
      const jitter = Math.random() * baseDelay;
      await new Promise(r => setTimeout(r, baseDelay * 2 ** i + jitter));
    }
  }
  throw new Error('unreachable');
}

私が守る 2 つのルール:

  1. 4xx は絶対にリトライしない。 404 がリトライで 200 になることはない。
  2. 合計待機時間に上限を設ける。 スピナーが 8 秒以上回っているなら、フォールバック UI を出してユーザーを先に進ませる。

サーキットブレーカーが連鎖障害を断つ

リトライは一過性のエラーを解決する。サーキットブレーカーは持続的な障害を解決する。バックエンドが 30 秒間失敗し続けているなら、これ以上叩くのをやめて回路を開き、すぐに劣化した応答を返す。

class Breaker {
  private failures = 0;
  private openUntil = 0;
  constructor(private threshold = 5, private cooldown = 30_000) {}

  async call<T>(fn: () => Promise<T>): Promise<T> {
    if (Date.now() < this.openUntil) throw new Error('Circuit open');
    try {
      const result = await fn();
      this.failures = 0;
      return result;
    } catch (e) {
      if (++this.failures >= this.threshold) {
        this.openUntil = Date.now() + this.cooldown;
      }
      throw e;
    }
  }
}

ブレーカーがなければ、遅い上流がハングした Node プロセスの群れを生む。あれば速い失敗が得られ、上流が戻った瞬間に復旧できる。

stale-while-revalidate によるエッジキャッシュ

Cache-Control ヘッダーは最も安い耐障害性レイヤーだ。stale-while-revalidate を使えば、エッジが最後のキャッシュを返しながら、バックグラウンドで新しいものを取得できる。

Cache-Control: public, s-maxage=60, stale-while-revalidate=600

「API が落ちたのでサイトも落ちた」と「API が落ちたので一部ユーザーに 10 分前のデータが見える」の違いがここにある。

フォールバック UI は機能

フォールバックは「壊れたときに見せるもの」ではなく、設計の一部だ。非同期セクションには 3 つの状態がある:

  • 読み込み中: 最終レイアウトに一致するスケルトン(レイアウトシフトなし)。
  • 成功: 実際のコンテンツ。
  • エラー: ユーザーが仕事を続けられる劣化版。

価格ウィジェットが失敗したら、赤いエラーを出すのではなく、最後にキャッシュした価格を「12 分前に更新」のバッジ付きで見せる。コメントシステムが落ちたら、読み取り専用のスレッドを表示して入力ボックスを隠す。

オフライン耐性

Service Worker は PWA だけのものではない。アプリシェルと直近 5 ページをキャッシュする最小限の SW があれば、不安定なホテルの Wi-Fi や高度 1 万メートルの機内でも本物のオフライン耐性が得られる。私にとっては、ブラウジングのかなりの割合を占めるシチュエーションだ。

// sw.ts — 静的ファイルは cache-first、ページは network-first
self.addEventListener('fetch', (e) => {
  const url = new URL(e.request.url);
  if (url.pathname.startsWith('/_next/static/')) {
    e.respondWith(caches.match(e.request).then(r => r ?? fetch(e.request)));
  }
});

実際に遭遇した障害

  • Cloudflare のエッジ KV 障害: KV に依存するすべてのページが 500 を返した。ISR ページは生き残った。
  • トラフィックスパイク中に上流 CMS にレート制限された。 ブレーカーがなく、Next.js が CMS を叩き続けて IP がハードバンされた。今ではすべての外部呼び出しが 30 秒クールダウン付きブレーカー経由。
  • <PriceTicker> 1 つが WebSocket 切断でダッシュボード全体をクラッシュさせた。 Boundary を追加後、残りの UI は動き続け、ティッカーは静かに再接続した。

耐障害性チェックリスト

  • 5 分以上の古さを許容できるコンテンツは ISR/SSG
  • キャッシュ可能なルートすべてに stale-while-revalidate
  • 独立したウィジェットすべてに Error Boundary
  • リトライは指数バックオフ + ジッター、4xx はリトライしない
  • 外部サービス呼び出しすべてにサーキットブレーカー
  • すべての非同期 UI にスケルトン + フォールバック + エラー状態
  • アプリシェルをキャッシュする Service Worker
  • 重要度の低い機能(分析、レコメンド)のキルスイッチを文書化

要点

耐障害性は最後にボルトで留める機能ではない。それ自体がアーキテクチャだ。レンダリング、キャッシュ、フェッチ、UI——すべてのレイヤーに障害モードを事前に設計する。早めに組み込んでおけば、本来なら障害になったインシデントが、誰も気づかない静かな劣化になる。

アニメーションアバター動画
Yakushev Hermann
ビジョナリーな創業者 · シニア Agentic AI アーキテクト · ネットワーキング

他の記事

y7.hk におけるモダンなエンジニアリング記事の解剖

y7 リーディングエンジンのストレステスト:コールアウト、diff ブロック、KaTeX 数式、丸型アバター動画、figure ギャラリー、スポイラー、フォント切り替え。

2026年10月15日 · 5 分で読める

タイムゾーンのあいだで生きる

65カ国と4つの生活拠点が教えてくれること — ディープワーク、時差ボケ、そして誰にも頼まれていないプロダクトを作ること。

2026年7月18日 · 6 分で読める