El frontend ya estaba compilado como HTML estático. Nginx servía directamente las páginas generadas y los archivos multimedia, pero sus procesos de trabajo consumían una cantidad inesperadamente alta de CPU al atender solicitudes normales. No había renderizado de Next.js por solicitud que optimizar. La operación costosa ocurría antes: nginx tenía que determinar si cada URL pertenecía a un conjunto cada vez mayor de redirecciones históricas.
La solución definitiva mantuvo funcionando los enlaces antiguos. Se conservaron las redirecciones de páginas, los alias de imágenes numeradas y los alias de vídeos, pero se sustituyeron miles de comparaciones de expresiones regulares por unas pocas coincidencias de patrones estructurales y búsquedas en tablas hash. El cambio se implementó y se probó frente al comportamiento original del sistema de rutas. Una prueba de rendimiento controlada y repetida mostró una reducción de más de cien veces en el tiempo de CPU de los procesos de trabajo de nginx para la combinación de solicitudes analizada, sin modificar las respuestas HTTP.
Por qué una exportación estática de Next.js seguía limitada por la CPU
La exportación estática elimina el renderizado de páginas de la ruta de procesamiento de cada solicitud, pero no elimina la lógica de enrutamiento de nginx. Antes de servir una página HTML o una imagen, nginx puede normalizar una ruta, evaluar mapas de redirección, seleccionar un bloque location, comprobar si existen los archivos y construir la respuesta. Un sistema de archivos rápido no compensa el coste de comparar URL mediante operaciones caras en cada solicitud.
La configuración había acumulado dos tipos de reglas históricas. Los alias exactos de páginas antiguas apuntaban a nuevas rutas canónicas. Los alias de paginación también redirigían rutas retiradas, pero seguían patrones estructurales comunes. Por otra parte, las rutas de archivos multimedia renombrados utilizaban expresiones que capturaban números de imagen opcionales, y los nombres de vídeo tenían sus propias reglas de alias. El problema no era la existencia de redirecciones, sino que grandes grupos de redirecciones con estructuras similares se habían codificado como expresiones regulares independientes.
Primero, descartar síntomas de CPU que se parecen entre sí
El sitio funcionaba sobre Linux virtualizado, por lo que el tiempo de CPU sustraído por el hipervisor (CPU steal) era una posible explicación inicial. Comparé el uso de CPU, el tiempo de steal, el consumo por proceso, la presión de memoria y los tiempos de espera del disco, en lugar de interpretar una carga media elevada como si fuera un diagnóstico. Utilicé estas herramientas básicas:
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
La observación principal fue que los procesos de trabajo de nginx consumían bastante CPU en espacio de usuario, mientras que el tiempo de CPU steal era relativamente bajo. Las mediciones no respaldaban que una espera sostenida del disco o un uso activo de la memoria de intercambio fueran la causa principal. El análisis por procesos me indicó qué programa consumía recursos; perf ayudó a determinar qué estaba haciendo.
En una de las muestras, aproximadamente un tercio de la actividad de CPU registrada se atribuyó a pcre_exec, con tiempo adicional en ngx_http_regex_exec y ngx_regex_exec. Son las funciones que cabe esperar cuando nginx ejecuta expresiones regulares mediante PCRE. El perfil no demostraba qué mapa de redirección concreto era responsable, pero hacía mucho más convincente la explicación de las evaluaciones repetidas de expresiones regulares que la de un problema con el renderizado de HTML estático.
El coste oculto de las entradas de expresiones regulares evaluadas secuencialmente en map de nginx
Un map de nginx no es lento por naturaleza. Las claves de cadena literales pueden encontrarse de forma eficiente, mientras que las entradas con expresiones regulares se consideran en el orden configurado, después de las categorías de coincidencia de mayor prioridad. Las variables de map se evalúan cuando se hace referencia a ellas, así que un mapa grande de expresiones regulares resulta costoso cuando su resultado se utiliza en una ruta de procesamiento frecuente. Una imagen canónica que ya existe y no coincide con ninguno de los alias históricos puede provocar numerosas comparaciones fallidas antes de que nginx sirva sus bytes.
Esta distinción también explica por qué habría sido engañoso contar todos los bloques location ~. La selección de bloques location mediante expresiones regulares y la evaluación de expresiones regulares dentro de map son mecanismos diferentes. El perfilado identifica el tipo de trabajo costoso; examinar la ruta de procesamiento de las solicitudes y dónde se utilizan las variables permite identificar dónde se activa ese trabajo.
Al aislar más el problema, descubrí que las listas de archivos multimedia no eran la única fuente. Un conjunto independiente de redirecciones de páginas paginadas también generaba un trabajo considerable con expresiones regulares cuando se evaluaba su mapa. Optimizar únicamente las imágenes habría dejado intacto ese coste independiente.
Redirecciones de páginas: un patrón de paginación, pero miles de destinos exactos
Las reglas de páginas eran repetitivas: las rutas diferían por un identificador antiguo y terminaban con un patrón de paginación, por ejemplo /topics/old-a/page/99. Una reescritura tentadora consistía en extraer 99 y añadirlo al nuevo slug. Habría sido incorrecto. Algunas reglas históricas de paginación dirigían deliberadamente cualquier número de página solicitado a una página final fija, por ejemplo /topics/current-a/page/7, tanto si la solicitud original pedía la página 3 como si pedía la 99.
Había otra restricción importante: nginx da prioridad a las claves exactas de map frente a las expresiones regulares. Algunas entradas exactas prevalecían sobre el resultado de la regla general de paginación. Otras apuntaban expresamente a una cadena vacía para impedir una redirección de una ruta que ya era canónica. Comprobar únicamente si el destino devuelto no estaba vacío habría eliminado la distinción entre ninguna coincidencia exacta y una coincidencia exacta cuyo valor está vacío.
La solución separó el reconocimiento de rutas de la selección de destinos. A continuación se muestra un ejemplo sintético y reducido de mapas de nginx definidos en el contexto http:
# 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;
}
El primer mapa conserva la normalización de la barra diagonal final. El segundo almacena las redirecciones exactas y las excepciones explícitas con valor vacío, y utiliza un valor centinela para indicar que no existe ninguna entrada exacta. El tercero emplea una sola expresión regular para extraer la raíz de paginación. El cuarto resuelve esa raíz mediante una búsqueda por clave exacta y obtiene su destino original fijo. Por último, el selector respeta cualquier coincidencia exacta, incluida la excepción de valor vacío, antes de considerar el resultado de paginación.
El servidor que realiza la redirección puede utilizar el valor resultante de $redirect_target solo cuando no está vacío, conservando el código de estado HTTP original y añadiendo $is_args$args cuando la política existente conserva las cadenas de consulta. El valor centinela debe estar reservado y validado para que nunca pueda coincidir con un destino real. El ejemplo utiliza rutas genéricas; el generador de producción tenía que conservar su inventario completo de correspondencias y las reglas de precedencia existentes.
En este diseño es fácil pasar por alto el tratamiento de mayúsculas y minúsculas. Nginx compara las claves de cadena literales de map sin distinguir entre mayúsculas y minúsculas, mientras que las expresiones regulares escritas con ~ sí las distinguen. Por tanto, no se puede convertir sin más todas las URL a minúsculas ni transformar una regla ~ en ~* y considerar equivalente el resultado. La solución debe reproducir la semántica original de coincidencia.
Redirecciones de imágenes y vídeos: analizar la ruta una vez y después buscar la clave antigua
Las reglas de archivos multimedia presentaban una estructura igualmente aprovechable. Una ruta antigua de imagen incluía un identificador de galería tanto en el directorio como en el nombre del archivo, además de un sufijo numérico opcional: /old-gallery/old-gallery-17.avif. El destino reutilizaba ese sufijo, pero sustituía el directorio y el prefijo del nombre de archivo. Generar una expresión regular por cada galería antigua y por cada variante de sufijo consumía CPU en comparaciones que compartían la misma estructura.
Un mapa más eficiente extrae el identificador y el sufijo opcional con una sola expresión regular y después busca el nuevo prefijo mediante una clave literal:
# 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.
Para un alias reconocido, /old-gallery/old-gallery-17.avif produce el destino candidato /new-gallery/new-gallery-17.avif. Este es el mecanismo de búsqueda, no una política completa de entrega de archivos. En la implementación real, la prioridad de los archivos existentes, las comprobaciones de existencia del archivo de destino y la decisión de devolver 301 seguían formando parte de la configuración que servía los archivos multimedia. Una redirección 301 incondicional en un ejemplo simplificado habría sido un sustituto incorrecto si el archivo de destino no existiera.
Las redirecciones de vídeo utilizaban una tabla equivalente de claves exactas, precedida por una sola expresión regular que reconocía la estructura del nombre de archivo. También era necesario conservar la ruta de compatibilidad WebP existente, que normalizaba la búsqueda de sus alias históricos para utilizar el mapa de imágenes. Una optimización de archivos multimedia solo es satisfactoria si los archivos actuales siguen devolviendo los bytes y las cabeceras correctos y si, al seguir un alias antiguo de vídeo, se sigue admitiendo 206 Partial Content para las solicitudes por rangos de bytes.
Estos ejemplos solo funcionan porque los inventarios históricos seguían una estructura predecible de nombres de archivo. Si se hubieran renombrado archivos individuales arbitrariamente y de forma independiente, el diseño seguro habría sido utilizar claves exactas por archivo, un índice generado u otro mecanismo de búsqueda acotado; no fingir que una única expresión regular puede reconstruir destinos sin un patrón común.
Qué ocurrió con el mapa independiente de respuestas 410
Otra parte de la configuración enumeraba explícitamente patrones de páginas retiradas con el único fin de devolver 410 Gone. Ese mapa especial se eliminó después de comprobar que la política existente de enrutamiento de archivos estáticos ya devolvía 410 para las páginas realmente inexistentes. Los metadatos históricos sobre las retiradas siguieron disponibles para las validaciones; solo se eliminó la comparación redundante realizada al procesar las solicitudes.
Esta decisión dependía de esa configuración concreta; no es el comportamiento predeterminado de nginx. Un try_files sin configuración adicional suele terminar en 404. Eliminar una regla explícita de 410 solo es seguro si la ruta de tratamiento de recursos inexistentes del servidor real sigue produciendo el 410 requerido, también para las URL de paginación retiradas y en presencia de cualquier procesamiento interno de páginas de error. Esta condición se comprobó con solicitudes HTTP reales antes de aceptar el cambio.
Cómo demostrar que un mapa de redirecciones más rápido conserva el mismo comportamiento
Una configuración de nginx sintácticamente válida puede romper silenciosamente miles de enlaces históricos. Por eso, la solución utilizó los inventarios de reglas originales como referencias independientes para comprobar la corrección, no como un conjunto de destinos reconstruidos a partir de la salida optimizada. En las tablas de búsqueda generadas se comprobaron las claves duplicadas, las expresiones no compatibles, los prefijos de imagen incoherentes y los archivos generados que no estaban actualizados. Cualquier regla que no pudiera representarse de forma segura debía provocar un error de generación en lugar de desaparecer.
La matriz de pruebas incluía alias exactos de páginas, excepciones canónicas con valor vacío, reglas de paginación superpuestas, límites fijos de paginación, números de página válidos e inválidos, barras diagonales finales, variantes de mayúsculas y minúsculas y cadenas de consulta. Para los archivos multimedia, cubría imágenes base y numeradas, sufijos con ceros iniciales, identificadores terminados en dígitos, rutas de destino anidadas, compatibilidad WebP y alias originales de vídeo. Cuando importaba el comportamiento al servir archivos, las pruebas utilizaban archivos de prueba reales y legibles y comparaban los cuerpos de las respuestas, las redirecciones, las cabeceras relacionadas con la caché y los rangos de bytes de los vídeos.
Lo más importante es que se trataba de comprobaciones HTTP reales contra nginx, no solo de comparaciones de cadenas en JavaScript. La nueva configuración se probó con toda la matriz de solicitudes generada, y otro conjunto de solicitudes se contrastó con la configuración original basada en PCRE. El resultado registrado fue de cero diferencias no intencionadas entre las respuestas. Posteriormente, las comprobaciones básicas en producción confirmaron que las configuraciones incluidas optimizadas estaban activas y que las antiguas tablas extensas de expresiones regulares ya no lo estaban.
Una prueba de rendimiento controlada permitió separar la mejora de los cambios de tráfico
Las gráficas de CPU en producción mejoraron considerablemente después del despliegue, pero también cambiaron el volumen y la combinación de solicitudes. Comparar una muestra de mucha actividad con otra posterior de poca actividad habría exagerado la parte de la mejora atribuible al cambio de configuración.
Para aislar el coste de búsqueda, una prueba de rendimiento independiente utilizó el mismo binario de nginx y repitió la misma secuencia mixta contra las configuraciones original y optimizada. La secuencia incluía páginas canónicas, alias históricos de páginas, alias de paginación, páginas inexistentes, imágenes canónicas, alias históricos de imágenes y vídeos y archivos multimedia inexistentes. Las ejecuciones se intercalaron en el orden original, nueva, nueva, original; coincidieron tanto los códigos de estado de las respuestas como los valores de Location.
Para esa carga de trabajo controlada, los mapas optimizados consumieron menos de una centésima parte del tiempo de CPU de los procesos de trabajo de nginx que los mapas originales con numerosas expresiones regulares; el resultado se reprodujo en ejecuciones repetidas. Es una medición sólida del cambio en el procesamiento de redirecciones para esa combinación de solicitudes. No significa que cada solicitud en producción se volviera 100 veces más rápida ni que el consumo global de CPU del servidor se redujera en la misma proporción con cualquier patrón de tráfico.
Las comprobaciones posteriores del sistema mostraron que nginx utilizaba poca CPU, con baja presión de E/S de disco y abundante tiempo de procesador inactivo. El anterior punto de mayor consumo asociado a PCRE dejó de dominar las muestras disponibles después del cambio; con una utilización tan baja, esas muestras eran escasas, por lo que no conviene sobreinterpretar sus porcentajes por función. La comparación controlada, las pruebas de equivalencia y el despliegue satisfactorio son evidencias más sólidas de la eficacia de la solución.
Un procedimiento más seguro para migrar grandes conjuntos de redirecciones en nginx
En otro sitio con muchas URL antiguas, mantendría la migración como un proceso mecánico: conservaría el inventario original de reglas, identificaría el pequeño conjunto de estructuras de ruta compartidas, convertiría cada estructura en una expresión regular de alcance acotado y almacenaría los destinos en mapas de claves literales. Trataría las excepciones exactas de rutas canónicas, los códigos de estado HTTP, las comprobaciones de archivos existentes, las cadenas de consulta, la normalización del host y la distinción entre mayúsculas y minúsculas como comportamientos observables públicamente, no como detalles accidentales de implementación.
Después validaría toda la configuración generada con nginx -t, compararía el comportamiento anterior y el nuevo mediante solicitudes reales a nginx, mediría el rendimiento con solicitudes idénticas y desplegaría el cambio con una copia de seguridad recuperable y comprobaciones posteriores a la recarga. Si una redirección no pudiera representarse mediante el esquema estructural, conservaría una excepción de alcance limitado o utilizaría una entrada exacta para esa URL, en lugar de eliminarla silenciosamente.
El cambio de enfoque decisivo para el diagnóstico fue reconocer que servir contenido estático y disponer de un enrutamiento de bajo coste son propiedades distintas. Next.js ya había terminado el trabajo de renderizado, y nginx podía servir archivos con eficiencia. Faltaba optimizar la búsqueda que se realizaba antes de servirlos. Mantener los enlaces antiguos era compatible con acelerar esa búsqueda.
Para conocer las reglas exactas de precedencia y evaluación, consulte la documentación oficial de nginx sobre el módulo map y la selección de bloques location en el módulo HTTP principal.