Das Frontend war bereits zu statischem HTML kompiliert. nginx lieferte die erzeugten Seiten und Mediendateien direkt aus, trotzdem verbrauchten seine Worker-Prozesse bei gewöhnlichen Anfragen unerwartet viel CPU-Zeit. Ein Rendering durch Next.js bei jeder Anfrage gab es nicht, das man hätte optimieren können. Die aufwendige Arbeit fand früher statt: nginx musste entscheiden, ob eine URL zu einer immer größeren Sammlung historischer Weiterleitungen gehörte.
Die schließlich umgesetzte Lösung ließ die alten Links weiterhin funktionieren. Seitenweiterleitungen sowie Aliasse für nummerierte Bilder und Videos blieben erhalten. Tausende Vergleiche mit regulären Ausdrücken wurden jedoch durch wenige Prüfungen der Pfadstruktur und Nachschlageoperationen in Hashtabellen ersetzt. Die Änderung wurde ausgerollt und gegen das ursprüngliche Routing-Verhalten getestet. Ein kontrollierter, mehrfach wiederholter Benchmark zeigte für den getesteten Anfragemix eine Reduktion der CPU-Zeit der nginx-Worker um mehr als den Faktor 100, ohne die HTTP-Antworten zu verändern.
Warum auch ein statischer Next.js-Export viel CPU-Zeit verbrauchen kann
Ein statischer Export verlagert das Rendern der Seiten aus der Anfrageverarbeitung heraus, beseitigt aber nicht die Routing-Logik von nginx. Bevor nginx eine HTML-Seite oder ein Bild ausliefern kann, muss es unter Umständen einen Pfad normalisieren, Weiterleitungs-Maps auswerten, eine Location auswählen, die Existenz von Dateien prüfen und eine Antwort zusammenstellen. Ein schnelles Dateisystem kann aufwendige URL-Vergleiche, die bei jeder Anfrage erneut stattfinden, nicht ausgleichen.
In der Konfiguration hatten sich zwei Arten historischer Regeln angesammelt. Exakte Aliasse für alte Seiten verwiesen auf neue kanonische Pfade. Auch Pagination-Aliasse leiteten nicht mehr verwendete Pfade weiter, folgten dabei aber gemeinsamen Strukturmustern. Daneben verwendeten umbenannte Medienpfade Ausdrücke, die optionale Bildnummern erfassten; für Videonamen gab es eigene Aliasregeln. Das Problem waren nicht die Weiterleitungen an sich, sondern dass große Gruppen strukturell ähnlicher Weiterleitungen als einzelne reguläre Ausdrücke hinterlegt waren.
Zuerst ähnliche Symptome mit anderen CPU-Ursachen ausschließen
Die Website lief unter virtualisiertem Linux. Deshalb kam zunächst auch CPU-Steal-Time durch den Hypervisor als Ursache infrage. Statt eine hohe Load Average bereits als Diagnose zu verstehen, verglich ich CPU-Auslastung, Steal-Time, CPU-Verbrauch einzelner Prozesse, Speicherdruck und Wartezeiten auf Datenträgerzugriffe. Dafür verwendete ich zunächst diese Werkzeuge:
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
Entscheidend war die Beobachtung, dass die nginx-Worker viel CPU-Zeit im Userspace verbrauchten, während die Steal-Time vergleichsweise gering war. Die Messwerte sprachen weder für dauerhaftes Warten auf Datenträgerzugriffe noch für aktives Swapping als Hauptursache. Die Prozessansicht zeigte mir, welches Programm beschäftigt war; perf half festzustellen, womit es beschäftigt war.
In einer Stichprobe entfiel ungefähr ein Drittel der erfassten CPU-Aktivität auf pcre_exec; weitere Zeit wurde in ngx_http_regex_exec und ngx_regex_exec verbracht. Diese Funktionen sind zu erwarten, wenn nginx reguläre Ausdrücke über PCRE ausführt. Das Profil bewies nicht, welche einzelne Weiterleitungs-Map verantwortlich war. Es machte die wiederholte Auswertung regulärer Ausdrücke aber zu einer deutlich plausibleren Erklärung als ein Problem beim Rendern statischer HTML-Seiten.
Die versteckten Kosten nacheinander geprüfter Regex-Einträge in nginx-Maps
Eine map in nginx ist nicht grundsätzlich langsam. Wörtliche Zeichenfolgenschlüssel lassen sich effizient nachschlagen, während Regex-Einträge nach den vorrangigen Übereinstimmungskategorien in der konfigurierten Reihenfolge geprüft werden. Map-Variablen werden ausgewertet, wenn auf sie zugegriffen wird. Eine große Regex-Map wird deshalb dann relevant, wenn ihr Ergebnis bei häufigen Anfragen benötigt wird. Selbst ein vorhandenes kanonisches Bild, auf das keiner der alten Aliasse zutrifft, kann zahlreiche erfolglose Vergleiche auslösen, bevor nginx die Bilddaten ausliefert.
Dieser Unterschied erklärt auch, warum es irreführend gewesen wäre, einfach alle location ~-Blöcke zu zählen. Die Auswahl von Regex-Locations und die Regex-Auswertung innerhalb einer map sind unterschiedliche Mechanismen. Das Profiling zeigt, welche Art von Arbeit teuer ist; die Untersuchung des Anfragepfads und der Stellen, an denen die Variablen verwendet werden, zeigt, wo diese Arbeit ausgelöst wird.
Bei der weiteren Eingrenzung stellte sich heraus, dass nicht nur die Medienlisten verantwortlich waren. Auch eine separate Gruppe von Seitenweiterleitungen für die Pagination verursachte erheblichen Regex-Aufwand, sobald ihre Map ausgewertet wurde. Hätte ich nur die Bildweiterleitungen optimiert, wäre dieser unabhängige Aufwand geblieben.
Seitenweiterleitungen: ein Pagination-Muster, aber Tausende exakte Ziele
Die Seitenregeln wiederholten sich: Die Pfade unterschieden sich durch eine alte Kennung, während das Pfadende einem Pagination-Muster wie /topics/old-a/page/99 folgte. Eine naheliegende Umschreibung wäre gewesen, 99 auszulesen und an einen neuen Slug anzuhängen. Das wäre falsch gewesen. Einige historische Pagination-Regeln leiteten jede angeforderte Seitennummer bewusst auf eine feste letzte Seite weiter, beispielsweise /topics/current-a/page/7 – unabhängig davon, ob ursprünglich Seite 3 oder Seite 99 angefordert wurde.
Eine weitere wichtige Bedingung kam hinzu: nginx gibt exakten map-Schlüsseln Vorrang vor regulären Ausdrücken. Einige exakte Einträge überschrieben das Verhalten der allgemeinen Pagination-Regel. Andere waren ausdrücklich auf eine leere Zeichenfolge gesetzt, um eine Weiterleitung für einen bereits kanonischen Pfad zu verhindern. Würde man nur prüfen, ob das zurückgegebene Ziel nicht leer ist, ginge der Unterschied zwischen keinem exakten Treffer und einem exakten Treffer mit leerem Wert verloren.
Die neue Lösung trennte die Erkennung des Pfads von der Auswahl des Ziels. Das folgende vereinfachte, schematische Beispiel zeigt die Maps auf der http-Ebene von nginx:
# 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;
}
Die erste Map behält die Normalisierung abschließender Schrägstriche bei. Die zweite speichert exakte Weiterleitungen und ausdrücklich leere Ausnahmen; ein Sentinel-Wert kennzeichnet, dass kein exakter Eintrag vorhanden ist. Die dritte extrahiert mit einem einzigen regulären Ausdruck den Stammpfad der Pagination. Die vierte löst diesen Stammpfad über einen exakten Schlüssel auf das ursprüngliche, fest vorgegebene Ziel auf. Abschließend berücksichtigt die Auswahl jeden exakten Treffer, auch die leere Ausnahme, bevor sie das Pagination-Ergebnis heranzieht.
Der Server kann den daraus resultierenden Wert $redirect_target für eine Weiterleitung verwenden, sofern er nicht leer ist. Der ursprüngliche HTTP-Status bleibt dabei erhalten. Wenn die bestehende Regelung Query-Strings beibehält, wird außerdem $is_args$args angehängt. Der Sentinel-Wert muss reserviert und überprüft werden, damit er niemals mit einem echten Ziel kollidiert. Das Beispiel verwendet neutrale Pfade; der Generator für die Produktivkonfiguration musste den vollständigen eigenen Regelbestand und die bisherige Prioritätsreihenfolge bewahren.
Bei dieser Konstruktion wird die Groß- und Kleinschreibung leicht übersehen. nginx vergleicht wörtliche map-Schlüssel ohne Berücksichtigung der Groß- und Kleinschreibung, während mit ~ notierte reguläre Ausdrücke zwischen beiden unterscheiden. Eine Ersatzlösung darf deshalb nicht einfach sämtliche URLs in Kleinbuchstaben umwandeln oder eine ~-Regel in ~* ändern und das Ergebnis für gleichwertig erklären. Sie muss das ursprüngliche Abgleichverhalten reproduzieren.
Bild- und Videoweiterleitungen: einmal parsen, dann den alten Schlüssel nachschlagen
Auch die Medienregeln hatten eine gut nutzbare gemeinsame Struktur. Ein alter Bildpfad enthielt dieselbe Galeriekennung sowohl im Verzeichnis als auch im Dateinamen, ergänzt um ein optionales numerisches Suffix: /old-gallery/old-gallery-17.avif. Das Ziel verwendete dieses Suffix weiter, ersetzte aber das Verzeichnis und den Dateinamenpräfix. Für jede alte Galerie und jede Suffixvariante einen eigenen regulären Ausdruck zu erzeugen, verschwendete CPU-Zeit mit Vergleichen, die alle derselben Grammatik folgten.
Eine effizientere Map extrahiert die Kennung und das optionale Suffix mit einem einzigen regulären Ausdruck und schlägt dann den neuen Präfix über einen wörtlichen Schlüssel nach:
# 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.
Für einen erkannten Alias ergibt /old-gallery/old-gallery-17.avif das mögliche Ziel /new-gallery/new-gallery-17.avif. Das ist der Nachschlagemechanismus, keine vollständige Regelung für die Dateiauslieferung. In der tatsächlichen Implementierung blieben der Vorrang bereits vorhandener Dateien, die Prüfung, ob die Zieldatei existiert, und die Entscheidung über einen 301-Status Teil der Medienkonfiguration. Ein bedingungsloser 301 in einem vereinfachten Beispiel wäre ein falscher Ersatz gewesen, wenn die Zieldatei gar nicht existierte.
Für Videoweiterleitungen wurde entsprechend eine Tabelle mit exakten Schlüsseln hinter einem einzigen regulären Ausdruck für die Dateinamenstruktur verwendet. Auch der vorhandene WebP-Kompatibilitätspfad musste erhalten bleiben: Er normalisierte die Suche nach historischen Aliasnamen auf die Bildzuordnung. Eine Medienoptimierung ist nur dann erfolgreich, wenn aktuelle Dateien weiterhin die richtigen Bytes und Header liefern und nach dem Folgen eines alten Video-Alias bei Range-Anfragen weiterhin 206 Partial Content unterstützt wird.
Diese Beispiele funktionieren nur, weil die historischen Regelbestände einer vorhersagbaren Dateinamengrammatik folgten. Wären beliebige Einzeldateien unabhängig voneinander umbenannt worden, wären exakte Schlüssel pro Datei, ein generierter Index oder ein anderer begrenzter Nachschlagemechanismus die sichere Lösung – nicht die Behauptung, ein einziger regulärer Ausdruck könne Ziele ohne gemeinsames Muster rekonstruieren.
Was aus der separaten 410-Map wurde
Ein weiterer Konfigurationsteil führte Muster für stillgelegte Seiten ausdrücklich auf, nur um 410 Gone zurückzugeben. Diese spezielle Map wurde entfernt, nachdem überprüft worden war, dass das vorhandene Routing für statische Dateien bei tatsächlich fehlenden Seiten ohnehin 410 zurückgab. Die historischen Metadaten über stillgelegte Seiten blieben für die Validierung verfügbar; entfernt wurde nur der redundante Abgleich während der Anfrageverarbeitung.
Diese Entscheidung gilt für die konkrete Konfiguration und ist kein Standardverhalten von nginx. Ein einfaches try_files endet ohne entsprechende Konfiguration häufig mit 404. Eine ausdrückliche 410-Regel kann nur dann sicher entfernt werden, wenn die Behandlung fehlender Ressourcen auf dem tatsächlichen Server weiterhin den geforderten 410-Status liefert – auch für stillgelegte Pagination-URLs und unter Berücksichtigung einer eventuellen internen Fehlerseitenbehandlung. Diese Bedingung wurde vor der Freigabe der Änderung durch echte HTTP-Anfragen überprüft.
Wie sich nachweisen lässt, dass eine schnellere Weiterleitungs-Map dieselbe Wirkung hat
Auch eine syntaktisch gültige nginx-Konfiguration kann unbemerkt Tausende historische Links beschädigen. Deshalb verwendete die neue Lösung die ursprünglichen Regelbestände als unabhängige Vorgaben für die Korrektheit, statt die Ziele aus der optimierten Ausgabe zurückzurechnen. Die generierten Nachschlagetabellen wurden auf doppelte Schlüssel, nicht unterstützte Ausdrücke, widersprüchliche Bildpräfixe und veraltete generierte Dateien geprüft. Ließ sich eine Regel nicht sicher abbilden, musste die Generierung fehlschlagen, statt die Regel stillschweigend wegzulassen.
Die Testmatrix deckte exakte Seitenaliase, kanonische Einträge mit leerem Weiterleitungsziel, überlappende Pagination-Regeln, feste Obergrenzen für Pagination-Ziele, gültige und ungültige Seitennummern, abschließende Schrägstriche, Varianten der Groß- und Kleinschreibung sowie Query-Strings ab. Für Medien umfasste sie Bilder mit und ohne Nummernsuffix, Suffixe mit führenden Nullen, auf Ziffern endende Kennungen, verschachtelte Zielpfade, die WebP-Kompatibilität und die ursprünglichen Videoaliase. Wo die Dateiauslieferung relevant war, nutzten die Tests tatsächlich lesbare Testdateien und verglichen Antwortinhalte, Weiterleitungen, Cache-bezogene Header und Bytebereiche von Videos.
Entscheidend war, dass es sich um echte HTTP-Tests gegen nginx handelte und nicht nur um Zeichenfolgenvergleiche in JavaScript. Die neue Konfiguration wurde mit der generierten Anfragematrix getestet; eine separate Anfragegruppe wurde gegen die ursprüngliche PCRE-basierte Konfiguration geprüft. Das dokumentierte Ergebnis: keine unbeabsichtigten Unterschiede in den Antworten. Anschließende Smoke-Tests in der Produktivumgebung bestätigten, dass die optimierten Include-Dateien aktiv waren und die früheren langen Regex-Tabellen nicht mehr verwendet wurden.
Ein kontrollierter Benchmark trennte den Effekt der Optimierung von Änderungen im Traffic
Nach dem Deployment zeigten die CPU-Grafiken der Produktivumgebung eine deutliche Verbesserung. Allerdings hatten sich auch die Zahl und die Zusammensetzung der Anfragen verändert. Ein Vergleich zwischen einer stark ausgelasteten Messung und einer späteren ruhigen Phase hätte den Anteil übertrieben, den man der Konfigurationsänderung zuschreiben konnte.
Um die Kosten der Nachschlageoperationen zu isolieren, verwendete ein unabhängiger Benchmark dieselbe nginx-Binärdatei und wiederholte dieselbe gemischte Anfragesequenz mit der ursprünglichen und der optimierten Konfiguration. Die Sequenz enthielt kanonische Seiten, historische Seitenaliase, Pagination-Aliasse, fehlende Seiten, kanonische Bilder, historische Bild- und Videoaliase sowie fehlende Medien. Die Durchläufe wurden in der Reihenfolge alt, neu, neu, alt verschachtelt; die Antwortstatus und Location-Werte stimmten überein.
Für diese kontrollierte Last benötigten die optimierten Maps weniger als ein Hundertstel der nginx-Worker-CPU-Zeit der ursprünglichen Regex-lastigen Maps. Das Ergebnis ließ sich in wiederholten Durchläufen reproduzieren. Das ist eine aussagekräftige Messung der geänderten Weiterleitungsverarbeitung für genau diesen Anfragemix. Es bedeutet nicht, dass jede Produktivanfrage 100-mal schneller wurde oder dass die gesamte CPU-Auslastung des Servers bei beliebigem Traffic im selben Verhältnis sinkt.
Spätere Systemprüfungen zeigten einen geringen CPU-Verbrauch von nginx, wenig Datenträgerdruck und reichlich ungenutzte CPU-Kapazität. Der frühere PCRE-Engpass dominierte die verfügbaren Stichproben nach der Änderung nicht mehr. Bei so geringer Auslastung waren diese Stichproben allerdings dünn besetzt; ihre prozentuale Verteilung auf einzelne Funktionen sollte man daher nicht überinterpretieren. Der kontrollierte Vergleich, die Tests auf identisches Verhalten und das erfolgreiche Deployment sind die stärkeren Belege für die Wirksamkeit der Änderung.
Ein sichereres Vorgehen bei großen nginx-Weiterleitungsmigrationen
Bei einer anderen Website mit vielen alten URLs würde ich die Migration möglichst mechanisch halten: den ursprünglichen Regelbestand bewahren, die wenigen gemeinsamen Pfadgrammatiken identifizieren, jede Grammatik in einen begrenzten regulären Ausdruck überführen und die Ziele in Maps mit wörtlichen Schlüsseln speichern. Exakte Ausnahmen für kanonische Pfade, HTTP-Statuscodes, Prüfungen vorhandener Dateien, Query-Strings, Host-Kanonisierung und Groß- und Kleinschreibung sind öffentlich sichtbares Verhalten und keine nebensächlichen Implementierungsdetails.
Anschließend würde ich die gesamte generierte Konfiguration mit nginx -t prüfen, das alte und neue Verhalten über echte nginx-Anfragen vergleichen, identische Anfragen benchmarken und mit einer wiederherstellbaren Sicherung sowie Prüfungen nach dem Reload deployen. Lässt sich eine Weiterleitung nicht mit dem strukturellen Schema darstellen, sollte eine eng begrenzte Ausnahme oder ein exakter Eintrag pro URL erhalten bleiben, statt die Regel stillschweigend zu verwerfen.
Der entscheidende Perspektivwechsel bei der Diagnose war die Erkenntnis, dass statische Auslieferung und kostengünstiges Routing zwei verschiedene Eigenschaften sind. Next.js hatte das Rendern bereits erledigt, und nginx konnte Dateien effizient ausliefern. Die fehlende Optimierung betraf die Nachschlageoperation, die vor der Dateiauslieferung stattfand. Die alten Links beizubehalten war durchaus damit vereinbar, diese Operation schnell zu machen.
Die genauen Vorrang- und Auswertungsregeln sind in der offiziellen nginx-Dokumentation zum Map-Modul und zur Location-Auswahl im HTTP-Core-Modul beschrieben.