Express.js
Explica cómo retirar tráfico, cerrar el servidor, drenar requests, detener workers y liberar conexiones durante despliegues o señales del sistema.
Graceful shutdown significa dejar de aceptar trabajo, permitir que lo activo termine dentro de un límite y liberar recursos antes de que el proceso sea forzado a morir.
En un despliegue o escalado, la plataforma envía una señal como SIGTERM. Si el proceso termina inmediatamente, corta requests, pierde jobs y deja conexiones sin limpiar.
SIGTERM
↓
not-ready
↓
dejar de aceptar conexiones
↓
drenar trabajo activo
↓
cerrar dependencias
↓
exit 0Necesitas referencia al servidor HTTP:
const server = createServer(app);
server.listen(port);app define el pipeline; server administra sockets y cierre.
let shuttingDown = false;
async function shutdown(signal: NodeJS.Signals) {
if (shuttingDown) return;
shuttingDown = true;
logger.info({ signal }, 'Shutdown started');
readiness.acceptingTraffic = false;
server.close(async (error) => {
if (error) {
logger.error({ error }, 'HTTP server close failed');
process.exitCode = 1;
}
await Promise.allSettled([
workers.close(),
pool.end(),
]);
});
}
process.on('SIGTERM', () => void shutdown('SIGTERM'));
process.on('SIGINT', () => void shutdown('SIGINT'));server.close deja de aceptar conexiones nuevas y espera conexiones atendidas, pero el comportamiento de keep-alive y sockets depende de versión/runtime.
Cerrar PostgreSQL antes de drenar requests provoca fallos internos.
La plataforma tiene un grace period. La aplicación necesita un timeout menor:
const forceTimer = setTimeout(() => {
logger.error('Forced shutdown after deadline');
server.closeAllConnections();
process.exit(1);
}, 25_000);
forceTimer.unref();El método exacto disponible depende de la versión de Node. Cierra conexiones inactivas y fuerza las restantes solo al superar el límite.
Puedes contar requests activas:
let activeRequests = 0;
app.use((_request, response, next) => {
activeRequests += 1;
response.once('finish', () => activeRequests -= 1);
response.once('close', () => activeRequests -= 1);
next();
});Evita decrementar dos veces usando una función once compartida. Métricas de active requests ayudan a saber cuándo drenó.
Una conexión keep-alive puede permanecer abierta. Durante shutdown:
Connection: close cuando corresponda.No confíes únicamente en que todos los clientes cierren rápido.
Un worker debe:
Si el proceso muere en medio, el job probablemente se reejecute; debe ser idempotente.
Conexiones persistentes no terminan solas. Notifica o cierra con intención, permitiendo que clientes reconecten con backoff a otra instancia.
Un error fatal puede dejar el proceso en estado desconocido. Registra y comienza shutdown, pero no intentes seguir operando indefinidamente.
No uses uncaughtException para convertir cualquier bug en continuidad silenciosa. Un supervisor debe reiniciar el proceso.
El proceso Node debe recibir señales. Scripts shell o un PID 1 mal configurado pueden impedir propagación. Usa exec form en Docker:
CMD ["node", "dist/server.js"]Durante deployment:
process.exit() inmediato.server.close?Logging estructurado y redacción de datos convierte cada lifecycle en evidencia diagnóstica segura.