フロントエンドはすでに静的 HTML にビルド済みだった。生成されたページとメディアファイルは nginx が直接配信していたが、それでも通常のリクエストを処理するだけでワーカープロセスが予想以上の CPU 時間を使っていた。リクエストごとに実行される Next.js のレンダリングはなく、そこに最適化の余地はなかった。重い処理はもっと手前にあった。nginx が、アクセスされた URL が増え続ける過去のリダイレクトルールに該当するかどうかを判定していたのだ。
最終的な修正では、古いリンクを引き続き利用できるようにした。ページのリダイレクト、番号付き画像の旧 URL、動画の旧 URL は維持しつつ、数千回に及ぶ正規表現の比較を、少数のパス構造の照合とハッシュテーブルによる検索に置き換えた。変更は本番環境に反映し、従来のルーティング動作と比較して検証した。条件を揃えて繰り返したベンチマークでは、テスト対象のリクエスト構成において、HTTP 応答を変えずに nginx ワーカーの CPU 時間が 100 分の 1 未満に減った。
静的エクスポートした Next.js サイトでも CPU がボトルネックになった理由
静的エクスポートによって、ページのレンダリングはリクエスト処理の経路から外れる。しかし、nginx のルーティング処理までなくなるわけではない。HTML ページや画像を配信する前に、nginx はパスの正規化、リダイレクトマップの評価、location の選択、ファイルの存在確認、レスポンスの生成などを行う場合がある。ファイルシステムが高速でも、リクエストのたびに重い URL 照合を繰り返していれば、そのコストは打ち消せない。
設定には、過去の URL に対応する異なる種類のルールが蓄積していた。古いページの完全一致エイリアスは、新しい正規 URL を指していた。廃止されたページネーション用 URL にもリダイレクトがあり、こちらには共通するパス構造があった。一方、名前を変更したメディアのパスでは、任意の画像番号を取得する正規表現を使っており、動画ファイル名には別のエイリアスルールがあった。問題はリダイレクトが存在すること自体ではない。同じ構造を持つ大量のルールを、一本ずつ独立した正規表現として定義していたことだった。
まず、似た症状を示す別の CPU 問題を除外する
サイトは仮想化された Linux 上で稼働していたため、最初はハイパーバイザーによる CPU steal も疑った。高いロードアベレージだけで原因を決めつけず、CPU 使用率、steal 時間、プロセス別の CPU 消費、メモリ逼迫、ディスク待ちを比較した。基本的に使ったコマンドは次のとおりだ。
mpstat -P ALL 1 5
pidstat -u -C nginx 1 5
vmstat -w 1 6
MASTER=$(systemctl show nginx -p MainPID --value)
WORKERS=$(pgrep -P "$MASTER" -d,)
perf record -F 49 -g -p "$WORKERS" -- sleep 10
perf report --stdio --no-children -g none
重要だったのは、CPU steal が比較的小さい一方、nginx のワーカーがユーザー空間でかなりの CPU を消費していたことだ。計測結果からは、持続的なディスク待ちや実際に発生しているスワップ処理が主因だとは考えにくかった。プロセス単位の情報で忙しいのがどのプログラムかを特定し、perf で何をしているのかを調べた。
あるサンプルでは、計測された CPU 処理の約 3 分の 1 が pcre_exec に割り当てられ、ngx_http_regex_exec と ngx_regex_exec にも処理時間が使われていた。これらは nginx が PCRE を通じて正規表現を実行する際に現れる関数だ。このプロファイルだけでは、どのリダイレクトマップが原因かまでは証明できない。しかし、静的 HTML のレンダリングよりも、正規表現の評価を何度も繰り返す処理のほうが、はるかに有力な説明になった。
nginx の map に並ぶ正規表現ルールの見えにくいコスト
nginx の map 自体が遅いわけではない。文字列の完全一致キーは効率的に検索できるが、正規表現のエントリは優先度の高い照合方式が処理された後、設定順に評価される。map の変数は参照されたときに評価されるため、リクエストごとに通る処理でその値を使う場合、大きな正規表現マップが問題になる。過去のエイリアスに一つも一致しない既存の正規画像でさえ、nginx がファイルを配信する前に多数の不一致判定を負担することがある。
この違いから、location ~ ブロックの数だけを数えても誤解を招く理由が分かる。正規表現による location の選択と、map 内での正規表現の評価は別の仕組みだ。プロファイリングでは重い処理の種類を特定できる。どこでその処理が発生するかは、リクエストの経路と変数の参照箇所を調べて突き止める。
さらに切り分けると、原因はメディア用のリストだけではなかった。ページネーション用のリダイレクトにも独立したルール群があり、そのマップが評価されるたびに相当量の正規表現処理が発生していた。画像だけを最適化しても、この別のコストは残るところだった。
ページのリダイレクト:ページネーションの形式は一つでも、転送先は数千件
ページ用のルールには繰り返しが多かった。パスごとに古い識別子は異なるものの、末尾は /topics/old-a/page/99 のような共通のページネーション形式になっていた。99 を取り出して新しいスラッグに付ければよさそうに見えるが、それでは間違いになる。過去の一部のルールは、要求されたページ番号が 3 でも 99 でも、すべてを /topics/current-a/page/7 のような固定の最終ページに転送するよう、意図的に定義されていたからだ。
もう一つ重要な制約があった。nginx では map の完全一致キーが正規表現より優先される。完全一致エントリの中には、一般的なページネーションルールの結果を上書きするものがあった。また、すでに正規 URL であるパスをリダイレクトしないよう、明示的に空文字列へ対応付けたものもあった。転送先が空でないかどうかだけを調べると、完全一致するルールが存在しない場合と、完全一致するが値が空である場合を区別できなくなる。
そこで、パスの識別と転送先の決定を分離した。次は、nginx の http コンテキストに置く map を簡略化した架空の例だ。
# http context: synthetic page aliases
map $uri $normalized_path {
default $uri;
~^(.+)/$ $1;
}
map $normalized_path $exact_target {
default "__NO_EXACT__";
/topics/old-a /topics/current-a;
/topics/old-a/page/2 /topics/current-a/page/2;
/topics/old-b/page/2 "";
}
map $normalized_path $pagination_key {
default "";
~^/(?<old_root>topics/[a-z0-9-]+)/page/[1-9][0-9]*$ /$old_root;
}
map $pagination_key $pagination_target {
default "";
/topics/old-a /topics/current-a/page/7;
/topics/old-b /topics/current-b/page/6;
}
map $exact_target $redirect_target {
default $exact_target;
__NO_EXACT__ $pagination_target;
}
最初のマップは末尾スラッシュの正規化を維持する。二つ目には完全一致のリダイレクトと、明示的に空を返す例外を保存する。完全一致エントリがないことは番兵値で表す。三つ目は一つの正規表現でページネーションのルートを抽出する。四つ目は、そのルートを完全一致キーで検索し、元のルールが指定していた固定の転送先を返す。最後の選択処理では、ページネーションの結果を見る前に、空の例外も含めた完全一致の結果を優先する。
リダイレクトを行うサーバー側では、得られた $redirect_target が空でない場合だけ利用できる。その際、元の HTTP ステータスを維持し、既存のルールでクエリ文字列を保持する場合には $is_args$args を付加する。番兵値が実際の転送先と衝突しないよう、予約して検証する必要がある。この例のパスは説明用のものだ。本番用ジェネレーターでは、実際のすべてのマッピングと既存の優先順位を保持する必要があった。
この設計では大文字と小文字の扱いも見落としやすい。nginx の map は文字列の完全一致キーを大文字と小文字を区別せず比較する一方、~ で記述した正規表現では両者を区別する。したがって、置き換え時に全 URL を安易に小文字化したり、~ を ~* に変更したりしても、同等とは言えない。元の照合規則を再現しなければならない。
画像・動画のリダイレクト:一度解析し、古いキーを検索する
メディア用のルールにも同様の構造があった。以前の画像パスでは、ディレクトリ名とファイル名の両方にギャラリーの識別子を含み、末尾には省略可能な番号が付いた。例えば /old-gallery/old-gallery-17.avif だ。転送先ではその番号を引き継ぎ、ディレクトリとファイル名の接頭辞だけを置き換えていた。古いギャラリーごと、番号の形式ごとに正規表現を作ると、共通の構文を持つパスに対して無駄な比較が繰り返される。
より効率的な map では、一つの正規表現で識別子と省略可能な番号部分を取り出し、その後、新しい接頭辞を文字列の完全一致キーで検索する。
# http context: synthetic AVIF rename inventory
map $uri $legacy_image_key {
default "";
~^/(?<old_id>[a-z0-9-]+)/\k<old_id>(?<image_number>-[0-9]+)?\.avif$ $old_id;
}
map $legacy_image_key $new_image_prefix {
default "";
old-gallery /new-gallery/new-gallery;
old-set /new-set/new-set;
}
# A recognized alias now has a target candidate:
# $new_image_prefix$image_number.avif
# Existing-file checks and the actual 301 remain
# in the site's media-serving configuration.
認識されたエイリアス /old-gallery/old-gallery-17.avif からは、転送先の候補 /new-gallery/new-gallery-17.avif が得られる。これは検索の仕組みを示すものであり、配信処理のすべてを定義したものではない。実際のデプロイでは、既存ファイルの優先、転送先ファイルの存在確認、301 を返すかどうかの判断は、引き続きメディア配信設定の中で行った。転送先ファイルが存在しない場合まで無条件に 301 を返す簡略例では、元の動作を正しく置き換えられない。
動画のリダイレクトでも、ファイル名の形式を判定する一つの正規表現の後ろに、同様の完全一致キーテーブルを置いた。従来の WebP 互換処理も維持する必要があった。これは、過去のエイリアスを画像のマッピングに合わせて正規化してから検索する経路だ。メディアの最適化が成功したと言えるのは、現行ファイルが引き続き正しいバイト列とヘッダーを返し、古い動画のエイリアス経由でも範囲リクエストに対する 206 Partial Content が機能する場合だけだ。
これらの例が成り立つのは、過去のルール一覧が予測可能なファイル名の構文に従っていたからだ。個々のファイル名が共通規則なしに別々に変更されているなら、ファイル単位の完全一致キー、生成したインデックス、または評価回数に上限のある別の検索方法を使うのが安全だ。一つの正規表現で、共通パターンのない転送先まで復元できるかのように扱ってはいけない。
独立した 410 用マップはどうなったか
設定の別の箇所には、410 Gone を返すためだけに、廃止したページのパターンを明示的に列挙したマップがあった。既存の静的ファイル用ルーティングでも、実際に存在しないページにはすでに 410 が返されることを確認してから、この専用マップを削除した。過去の廃止情報は検証用に残し、リクエスト時に行われていた重複した照合だけを取り除いた。
これはそのサーバー設定だからこそ可能だった判断で、nginx のデフォルト動作ではない。素の try_files は、別途設定しなければ 404 に行き着くことが多い。明示的な 410 ルールを削除して安全なのは、実際のサーバーで存在しないリソースを扱う経路が、廃止されたページネーション URL や内部エラーページ処理も含めて、必要な 410 を返す場合だけだ。この条件は、変更を採用する前に実際の HTTP リクエストで確認した。
高速化したリダイレクトマップの動作が元と同じだと証明する方法
nginx の設定が構文的に正しくても、過去の数千件のリンクが気づかないうちに壊れる可能性はある。そこで置き換え後の正しさを確認する入力には、最適化済みの出力から復元した転送先ではなく、元のルール一覧を独立した基準として使った。生成された検索テーブルについて、キーの重複、未対応の式、画像の接頭辞の不整合、古い生成ファイルの残存をチェックした。安全に表現できないルールは、黙って消すのではなく生成処理を失敗させる必要があった。
テスト用のリクエスト群には、ページの完全一致エイリアス、正規 URL に対する空の例外、重複するページネーションルール、固定の最終ページ番号、有効・無効なページ番号、末尾スラッシュ、大文字小文字の違い、クエリ文字列を含めた。メディアでは、番号なし・番号付き画像、先頭にゼロを含む番号、数字で終わる識別子、階層化された転送先パス、WebP 互換性、従来の動画エイリアスを検証した。ファイル配信の動作が重要なケースでは、実際に読み取れるテスト用ファイルを使用し、レスポンス本文、リダイレクト、キャッシュ関連ヘッダー、動画のバイト範囲を比較した。
特に重要なのは、これらが JavaScript で文字列を比較しただけではなく、実際の nginx を通した HTTP テストだったことだ。新しい設定には生成したリクエスト群を実行し、別途、元の PCRE ベースの設定でもリクエストを確認した。報告された結果では、意図しないレスポンス差異はゼロだった。その後の本番環境でのスモークテストでも、最適化した include 設定が有効で、以前の長大な正規表現テーブルは使われていないことを確認した。
トラフィック変動と切り分けて改善を測るベンチマーク
デプロイ後、本番環境の CPU グラフは大幅に改善した。ただし、リクエスト数もリクエストの内訳も変化していた。負荷が高いときの測定結果と、後の静かな時間帯の測定結果をそのまま比べれば、設定変更による効果を過大評価してしまう。
検索処理自体のコストを切り分けるため、nginx のバイナリを同一にした独立のベンチマークで、変更前と変更後の設定に対して同じリクエストの混合シーケンスを繰り返し送った。正規ページ、過去のページエイリアス、ページネーションのエイリアス、存在しないページ、正規画像、過去の画像・動画エイリアス、存在しないメディアを含めた。実行順は旧・新・新・旧と交互にし、レスポンスのステータスと Location の値が一致することも確認した。
この条件を揃えたワークロードでは、最適化したマップが消費した nginx ワーカーの CPU 時間は、正規表現を多用した元のマップの100 分の 1 未満で、再実行しても同じ結果が得られた。これは、そのリクエスト構成におけるリダイレクト処理の変更を強く裏付ける測定結果だ。本番環境のすべてのリクエストが 100 倍高速化したとか、トラフィックの内容によらずサーバー全体の CPU 使用量が同じ比率で減る、という意味ではない。
後のシステムチェックでは、nginx の CPU 使用量は少なく、ディスクへの負荷も低く、CPU のアイドル時間も十分にあった。以前目立っていた PCRE の処理集中は、変更後に得られたサンプルでは支配的ではなくなった。ただし、使用率が低いためサンプル数も少なく、関数ごとの割合を過度に解釈するべきではない。今回の修正を裏付けるより強い証拠は、条件を揃えた比較、応答の同等性テスト、そして本番導入の成功だ。
大量の nginx リダイレクトを安全に移行する手順
古い URL が大量にある別のサイトで同じことをするなら、移行は機械的に進めたい。元のルール一覧を残し、共通するパス構文を少数に整理し、それぞれを評価対象が限定された正規表現にまとめ、転送先は文字列の完全一致キーを使う map に保存する。正規 URL に対する完全一致の例外、HTTP ステータスコード、既存ファイルの確認、クエリ文字列、ホスト名の正規化、大文字小文字の区別は、単なる実装の細部ではなく、外部に見える動作として扱う。
そのうえで、生成した設定全体を nginx -t で検証し、実際の nginx を通して旧設定と新設定の動作を比較し、同じリクエストを使ってベンチマークし、復元可能なバックアップとリロード後のチェックを用意してデプロイする。構造に基づく方式では表現できないリダイレクトは、黙って落とさず、適用範囲を絞った例外として残すか、URL 単位の完全一致エントリにする。
診断で重要だったのは、静的ファイルの配信と、ルーティング処理の軽さは別の性質だと気づいたことだ。Next.js はレンダリングをすでに終えており、nginx もファイル自体は効率よく配信できていた。最適化されていなかったのは、そのファイルを返す前に行われる検索処理だった。古いリンクを維持することと、その検索を高速化することは両立できた。
照合の優先順位と評価方法の正確な規則については、nginx の公式ドキュメントにある map モジュールとHTTP コアモジュールの location 選択を参照してほしい。