Torna al blog
17 novembre 2026Sergei Solod14 min di lettura

Consumo elevato di CPU da parte di nginx su un sito Next.js statico: ottimizzare i redirect con regex

Un sito Next.js statico consumava molta CPU per le mappe di redirect basate su regex di nginx. Scopri come le ricerche per chiavi esatte, i test di equivalenza HTTP reali e i benchmark controllati hanno mantenuto funzionanti i vecchi URL di pagine e media, riducendo nettamente il lavoro della CPU.

NginxPrestazioniPCREReindirizzamentiNext.js

Il frontend era già stato compilato in HTML statico. Nginx serviva direttamente le pagine generate e i file multimediali, eppure i suoi processi worker consumavano una quantità sorprendentemente elevata di tempo CPU per gestire normali richieste. Non c'era alcun rendering Next.js da ottimizzare a ogni richiesta. L'operazione costosa avveniva prima: nginx doveva stabilire se ciascun URL rientrasse in una raccolta sempre più ampia di vecchie regole di reindirizzamento.

La soluzione adottata alla fine ha mantenuto funzionanti i vecchi link. Sono rimasti i redirect delle pagine, gli alias delle immagini numerate e quelli dei video, ma migliaia di confronti con espressioni regolari sono stati sostituiti da poche verifiche di struttura e ricerche in tabelle hash. La modifica è stata distribuita e verificata rispetto al comportamento di instradamento originale. Un benchmark controllato e ripetuto ha mostrato, per la combinazione di richieste esaminata, una riduzione di oltre cento volte del tempo CPU impiegato dai worker di nginx, senza modificare le risposte HTTP.

Perché un export statico di Next.js rimaneva limitato dalla CPU

L'esportazione statica elimina il rendering delle pagine dal percorso di elaborazione delle richieste, ma non la logica di instradamento di nginx. Prima di servire una pagina HTML o un'immagine, nginx potrebbe dover normalizzare un percorso, valutare le mappe di redirect, selezionare una direttiva location, controllare l'esistenza dei file e costruire una risposta. Un file system veloce non può compensare il costo di una ricerca delle corrispondenze degli URL ripetuta a ogni richiesta.

Nel tempo, la configurazione aveva accumulato due tipi di regole storiche. Gli alias delle vecchie pagine, definiti con corrispondenze esatte, puntavano ai nuovi percorsi canonici. Anche gli alias di paginazione reindirizzavano percorsi dismessi, ma seguivano schemi strutturali comuni. Separatamente, i percorsi dei file multimediali rinominati usavano espressioni che catturavano eventuali numeri delle immagini, mentre i nomi dei video avevano regole di alias dedicate. Il problema non era la presenza di redirect, ma il fatto che grandi gruppi di redirect con strutture simili fossero stati codificati come singole regex.

Escludere prima le cause che producono sintomi simili sulla CPU

Il sito girava su Linux virtualizzato, quindi inizialmente era plausibile che una parte del tempo CPU fosse sottratta dall'hypervisor (CPU steal). Invece di considerare un load average elevato come una diagnosi, ho confrontato l'utilizzo della CPU, lo steal time, il consumo per processo, la pressione sulla memoria e i tempi di attesa del disco. Gli strumenti principali erano:

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

L'osservazione decisiva è stata che i worker di nginx consumavano molto tempo CPU in spazio utente, mentre lo steal time era relativamente basso. Le misurazioni non indicavano un'attesa persistente del disco o un'attività di swap come spiegazione principale. L'analisi per processo mi ha mostrato quale programma fosse impegnato; perf ha aiutato a capire che cosa stesse facendo.

In un campione, circa un terzo dell'attività CPU campionata era attribuito a pcre_exec, con altro tempo trascorso in ngx_http_regex_exec e ngx_regex_exec. Sono le funzioni che ci si aspetta di trovare quando nginx esegue espressioni regolari tramite PCRE. Il profilo non dimostrava quale specifica mappa di redirect fosse responsabile, ma rendeva le valutazioni ripetute delle regex una spiegazione molto più convincente di un problema con il rendering dell'HTML statico.

Il costo nascosto delle regex valutate in sequenza nelle direttive map di nginx

Una direttiva map di nginx non è intrinsecamente lenta. Le chiavi letterali possono essere cercate in modo efficiente, mentre le voci regex vengono esaminate nell'ordine di configurazione, dopo le categorie di corrispondenza con priorità superiore. Le variabili definite da queste direttive vengono valutate quando sono referenziate: una mappa molto estesa di regex diventa quindi rilevante se il suo risultato viene utilizzato in un percorso di elaborazione frequente. Anche un'immagine canonica già esistente, che non corrisponde ad alcun vecchio alias, può pagare il costo di molti confronti falliti prima che nginx ne serva i byte.

Questa distinzione spiega anche perché contare tutti i blocchi location ~ sarebbe stato fuorviante. La selezione delle direttive location tramite regex e la valutazione delle regex all'interno di map sono meccanismi diversi. Il profiling individua la categoria di operazioni costose; l'esame del percorso della richiesta e dei punti in cui vengono usate le variabili permette di capire dove si attivano quelle operazioni.

Un'analisi più mirata ha rivelato che le liste dei media non erano l'unica causa. Anche un insieme separato di redirect per le pagine paginate richiedeva un lavoro considerevole sulle regex ogni volta che veniva valutata la relativa mappa. Ottimizzare soltanto le immagini avrebbe lasciato intatto questo costo indipendente.

Redirect delle pagine: un solo schema di paginazione, ma migliaia di destinazioni esatte

Le regole delle pagine erano ripetitive: i percorsi differivano per un vecchio identificatore e terminavano con uno schema di paginazione come /topics/old-a/page/99. Una riscrittura apparentemente comoda avrebbe estratto 99 e lo avrebbe aggiunto al nuovo slug. Sarebbe stato sbagliato. Alcune vecchie regole di paginazione indirizzavano deliberatamente qualsiasi numero di pagina richiesto verso una pagina finale fissa, per esempio /topics/current-a/page/7, indipendentemente dal fatto che la richiesta iniziale riguardasse la pagina 3 o la pagina 99.

C'era un altro vincolo importante: nginx assegna alle chiavi esatte di una direttiva map la precedenza sulle regex. Alcune voci esatte prevalevano quindi sul comportamento previsto dalla regola generale di paginazione. Altre restituivano esplicitamente una stringa vuota per evitare di reindirizzare un percorso già canonico. Controllare soltanto che la destinazione restituita non fosse vuota avrebbe cancellato la differenza tra nessuna corrispondenza esatta e una corrispondenza esatta con valore vuoto.

La nuova soluzione separava il riconoscimento del percorso dalla scelta della destinazione. Ecco un esempio sintetico e semplificato delle direttive map nel contesto http di 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;
}

La prima mappa conserva la normalizzazione della barra finale. La seconda contiene i redirect esatti e le eccezioni esplicite con valore vuoto, usando un valore sentinella per indicare che non esiste alcuna voce esatta. La terza usa un'unica regex per estrarre la radice di un percorso paginato. La quarta risolve quella radice mediante una ricerca per chiave esatta, recuperando la destinazione fissa originale. Infine, il selettore rispetta qualsiasi corrispondenza esatta, comprese le eccezioni con valore vuoto, prima di considerare il risultato della paginazione.

Il server che gestisce i redirect può quindi usare il valore $redirect_target solo quando non è vuoto, mantenendo il codice di stato HTTP originale e aggiungendo $is_args$args quando la politica esistente prevede di conservare la stringa di query. Il valore sentinella deve essere riservato e verificato, in modo che non possa mai coincidere con una destinazione reale. L'esempio usa percorsi neutri; in produzione, il generatore doveva preservare il proprio inventario completo delle corrispondenze e le precedenze già esistenti.

In questo approccio è facile trascurare la gestione delle maiuscole e delle minuscole. Nginx confronta le chiavi stringa letterali di map senza distinguere tra maiuscole e minuscole, mentre le regex introdotte da ~ distinguono la differenza. Una sostituzione non può quindi convertire disinvoltamente tutti gli URL in minuscolo, né trasformare una regola ~ in ~*, e considerare il risultato equivalente. Deve riprodurre la semantica delle corrispondenze originali.

Redirect di immagini e video: analizzare una volta il percorso, poi cercare la vecchia chiave

Le regole dei media presentavano una struttura altrettanto utile. Un vecchio percorso di immagine conteneva l'identificatore della galleria sia nella directory sia nel nome del file, con un suffisso numerico facoltativo: /old-gallery/old-gallery-17.avif. La destinazione riutilizzava quel suffisso, ma sostituiva la directory e il prefisso del nome del file. Generare una regex per ogni vecchia galleria e per ogni forma del suffisso sprecava tempo CPU in confronti basati sulla stessa grammatica.

Una mappa più efficiente estrae l'identificatore e il suffisso facoltativo con un'unica regex, poi cerca il nuovo prefisso mediante una chiave letterale:

# 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.

Per un alias riconosciuto, /old-gallery/old-gallery-17.avif produce la destinazione candidata /new-gallery/new-gallery-17.avif. Questo è il meccanismo di ricerca, non una politica completa per servire i file. Nella configurazione effettivamente distribuita, la precedenza dei file esistenti, la verifica dell'esistenza dei file di destinazione e la decisione di restituire un 301 rimanevano parte della configurazione di distribuzione dei media. Un redirect 301 incondizionato in un esempio semplificato sarebbe stato una sostituzione errata se il file di destinazione non fosse esistito.

I redirect dei video usavano una tabella analoga di chiavi esatte, preceduta da un'unica regex che riconosceva la struttura del nome del file. Doveva rimanere intatto anche il percorso di compatibilità WebP esistente, che normalizzava la ricerca dei vecchi alias facendola passare per la mappatura delle immagini. Un'ottimizzazione dei media riesce soltanto se i file attuali continuano a restituire i byte e gli header corretti e se, seguendo un vecchio alias video, sono ancora supportate le risposte 206 Partial Content alle richieste di intervalli di byte.

Questi esempi funzionano soltanto perché gli inventari storici seguivano una grammatica prevedibile per i nomi dei file. Se singoli file fossero stati rinominati indipendentemente, la soluzione sicura avrebbe previsto chiavi esatte per ogni file, un indice generato o un altro meccanismo di ricerca con un costo limitato, senza fingere che un'unica regex potesse ricostruire destinazioni prive di uno schema comune.

Che fine ha fatto la mappa separata per le risposte 410?

Un'altra parte della configurazione elencava esplicitamente schemi di pagine ritirate dal sito al solo scopo di restituire 410 Gone. Quella mappa dedicata è stata rimossa dopo aver verificato che la politica esistente di instradamento dei file statici restituiva già il codice 410 per le pagine effettivamente mancanti. I metadati storici delle pagine ritirate sono rimasti disponibili per le verifiche; è stata eliminata soltanto la ricerca ridondante effettuata durante la gestione delle richieste.

È una scelta specifica di quella configurazione, non il comportamento predefinito di nginx. Una semplice direttiva try_files termina spesso con una risposta 404, a meno che non sia configurata diversamente. Eliminare una regola 410 esplicita è sicuro solo se il percorso di gestione delle risorse mancanti sul server reale continua a produrre il codice 410 richiesto, anche per gli URL di paginazione ritirati e in presenza di eventuali meccanismi interni di gestione delle pagine di errore. Questa condizione è stata verificata con richieste HTTP reali prima di approvare la modifica.

Come dimostrare che una mappa di redirect più veloce mantiene lo stesso comportamento

Una configurazione nginx sintatticamente valida può comunque rompere senza segnali evidenti migliaia di vecchi link. Per questo la sostituzione ha usato gli inventari originali delle regole come riferimenti indipendenti per verificarne la correttezza, non come un insieme di destinazioni ricostruite dall'output ottimizzato. Le tabelle di ricerca generate sono state controllate per individuare chiavi duplicate, espressioni non supportate, prefissi delle immagini incoerenti e file generati non aggiornati. Se una regola non poteva essere rappresentata in sicurezza, la generazione doveva fallire anziché eliminarla silenziosamente.

La matrice dei test copriva gli alias esatti delle pagine, le eccezioni canoniche con valore vuoto, le sovrapposizioni tra regole di paginazione, i limiti fissi della paginazione, i numeri di pagina validi e non validi, le barre finali, le varianti di maiuscole e minuscole e le stringhe di query. Per i media includeva immagini di base e numerate, suffissi con zeri iniziali, identificatori che terminavano con cifre, percorsi di destinazione annidati, compatibilità WebP e alias video originali. Quando contava il comportamento reale della distribuzione dei file, i test utilizzavano file di prova effettivamente leggibili e confrontavano i corpi delle risposte, i redirect, gli header relativi alla cache e gli intervalli di byte dei video.

Soprattutto, si trattava di verifiche HTTP reali eseguite tramite nginx, non soltanto di confronti tra stringhe in JavaScript. La nuova configurazione è stata provata sull'intera matrice di richieste generata, mentre un insieme separato di richieste è stato confrontato con la configurazione originale basata su PCRE. Il risultato riportato era l’assenza di differenze indesiderate nelle risposte. Successivi controlli rapidi in produzione hanno confermato che i file di configurazione inclusi ottimizzati erano attivi e che le vecchie lunghe tabelle di regex non lo erano più.

Un benchmark controllato ha separato il miglioramento dai cambiamenti del traffico

I grafici di utilizzo della CPU in produzione sono migliorati sensibilmente dopo la distribuzione, ma erano cambiati anche il volume e la composizione delle richieste. Confrontare un campione raccolto sotto carico con uno successivo, in un periodo tranquillo, avrebbe esagerato il miglioramento attribuibile alla modifica della configurazione.

Per isolare il costo delle ricerche, un benchmark indipendente ha usato lo stesso binario nginx e ripetuto la stessa sequenza mista di richieste sulle configurazioni originale e ottimizzata. La sequenza comprendeva pagine canoniche, vecchi alias di pagine, alias di paginazione, pagine mancanti, immagini canoniche, vecchi alias di immagini e video e media mancanti. Le esecuzioni sono state alternate nell'ordine vecchia, nuova, nuova, vecchia; i codici di risposta e i valori dell'header Location coincidevano.

Per quel carico di lavoro controllato, le mappe ottimizzate consumavano meno di un centesimo del tempo CPU dei worker di nginx rispetto alle vecchie mappe ricche di regex, con un risultato riprodotto in più esecuzioni. È una misura solida del miglioramento apportato all'elaborazione dei redirect con quella specifica combinazione di richieste. Non significa che ogni richiesta in produzione sia diventata 100 volte più veloce, né che il consumo complessivo di CPU del server diminuisca nella stessa proporzione con qualsiasi tipo di traffico.

Controlli successivi del sistema hanno rilevato un basso utilizzo della CPU da parte di nginx, poca pressione sul disco e un'ampia disponibilità di tempo di calcolo inattivo. Il precedente punto caldo di PCRE non dominava più i campioni disponibili dopo la modifica; con un utilizzo così basso, però, i campioni erano pochi e le percentuali attribuite alle singole funzioni non vanno sovrainterpretate. Il confronto controllato, i test di equivalenza e la distribuzione riuscita sono le prove più solide dell'efficacia della correzione.

Un metodo più sicuro per migrare grandi insiemi di redirect nginx

Per un altro sito con molti vecchi URL, manterrei la migrazione il più possibile meccanica: conservare l'inventario originale delle regole, identificare le poche strutture comuni dei percorsi, tradurre ciascuna struttura in una regex a portata limitata e memorizzare le destinazioni in mappe basate su chiavi letterali. Le eccezioni esatte per i percorsi canonici, i codici di stato HTTP, i controlli sull'esistenza dei file, le stringhe di query, la canonicalizzazione degli host e la distinzione tra maiuscole e minuscole fanno parte del comportamento pubblico, non sono dettagli di implementazione trascurabili.

Occorre poi validare l'intera configurazione generata con nginx -t, confrontare il vecchio e il nuovo comportamento usando richieste reali a nginx, eseguire benchmark con richieste identiche e distribuire la modifica disponendo di un backup ripristinabile e di verifiche dopo il ricaricamento. Se un redirect non può essere rappresentato dallo schema strutturale, è meglio conservare un'eccezione strettamente circoscritta o utilizzare una voce esatta per singolo URL, anziché eliminarlo senza segnalarlo.

Il cambiamento decisivo nella diagnosi è stato riconoscere che servire file statici e instradare le richieste con un costo ridotto sono due proprietà distinte. Next.js aveva già svolto il lavoro di rendering e nginx era in grado di servire i file in modo efficiente. Mancava l'ottimizzazione della ricerca effettuata prima di servirli. Mantenere funzionanti i vecchi link era compatibile con l'accelerazione di quella ricerca.

Per le regole esatte di precedenza e valutazione, consulta la documentazione ufficiale di nginx relativa al modulo map e alla selezione delle direttive location nel modulo HTTP core.