Mejores prácticas de rendimiento

Perfila la concurrencia similar a la producción, no los "hola mundo" curls. Estas reglas mantienen las API de Node.js rápidas bajo tráfico real.

Cómo usar esta lista

• Establece la línea base de p95/RPS con k6 antes de cualquier sprint de optimización.
• Combina pruebas de carga con clinic.js cuando la latencia disminuye sin errores obvios.
• Revisa antes de implementar endpoints de lista, cargas de archivos o nuevas cadenas de middleware.
• Vuelve a ejecutar los umbrales en CI después de las actualizaciones de dependencias.

A - Mide primero

• Registra la latencia p95, la tasa de errores y el RPS antes de cambiar el código. Los números superan la intuición en las discusiones de PR.
• Usa concurrencia sostenida (50+ VUs), no curls individuales. Los bloques se ocultan hasta que las solicitudes se superponen.
• Exporta el p99 de retardo del bucle de eventos desde monitorEventLoopDelay. El retraso del bucle predice el problema del usuario temprano.
• Establece umbrales de k6 en CI para escenarios de prueba de humo. Fallan las fusiones cuando el p95 retrocede más allá del SLO.
• Compara el entorno de staging con un volumen de datos con forma de producción. Las bases de datos vacías mienten sobre el costo de la consulta y la serialización.

B - Higiene del hilo principal

• No realices trabajos síncronos que consuman mucha CPU en la ruta de la solicitud. Mueve el hashing, la generación de PDF y el cambio de tamaño de imágenes a los workers.
• Limita el tamaño del cuerpo JSON en el analizador (limit: "1mb" o más estricto). Rechaza el abuso antes de que se ejecute JSON.parse.
• Reduce las formas de respuesta en las capas de la base de datos y del mapeador. Nunca serialices entidades ORM completas a los clientes.
• Evita las API *Sync de fs y crypto en los manejadores HTTP. Usa variantes de promesa/asíncronas.
• Deshabilita el registro verboso y pino-pretty durante la creación de perfiles. La E/S de registro sesga los resultados de clinic y de carga.

C - Serialización y memoria

• Usa JSON Schema + fast-json-stringify en rutas de lectura frecuentes. Fastify hace esto por defecto cuando se configuran los esquemas.
• Pagina los endpoints de lista. Los arrays grandes multiplican el costo de serialización y GC.
• Corrige las fugas de heap antes de aumentar --max-old-space-size. Instantáneas en staging, no conjeturas.
• Establece el heap en ~60-70% del límite de memoria del contenedor. Deja espacio para búferes nativos y TLS.
• Transmite descargas grandes en lugar de almacenarlas en búfer en la memoria. Las respuestas en fragmentos estabilizan el RSS.

D - Herramientas y perfilado

• Ejecuta clinic Doctor primero, Flame para CPU, Bubbleprof para asíncrono. Haz coincidir la herramienta con el síntoma.
• Genera carga durante la captura de Flame (autocannon o k6). Los servidores inactivos producen gráficos vacíos.
• Perfila las compilaciones de producción cuando sea posible. Los mapas de origen mejoran los nombres de los símbolos.
• Documenta el punto de saturación (VUs donde el p99 se dispara). El autoescalado y el dimensionamiento del pool dependen de ello.
• Vuelve a perfilar después de las actualizaciones principales de Node. El comportamiento de GC y la pila HTTP cambia entre las líneas LTS.

E - Arquitectura y escala

• Paraleliza E/S independientes con Promise.all. Las cadenas await seriales añaden latencia linealmente.
• Ajusta el tamaño de los pools de conexión de la base de datos y HTTP. La espera del pool se muestra como latencia de la aplicación, no como CPU de la base de datos.
• Sabe cuándo la optimización de Express no es suficiente. Consulta Rendimiento en Express vs Fastify ADR.
• Escala réplicas para trabajos ligados a E/S; workers para trabajos ligados a CPU. La escala horizontal no corrige los bloques del hilo principal.
• Define SLOs de rendimiento junto con la disponibilidad. Vincula a los presupuestos de errores en SLOs y presupuestos de errores.

Preguntas frecuentes

Relacionado

• Conceptos básicos de rendimiento - ejemplos introductorios
• Pruebas de carga - escenarios de k6
• Suite clinic.js - herramientas de perfilado
• Mejores prácticas del bucle de eventos - patrones sin bloqueo

Versiones de la pila: Esta página fue escrita para Node.js 24.18.0 (LTS activa), npm 10+, TypeScript 5.6+, Express 5, Fastify 5 y NestJS 11.