Política de Lanzamiento y LTS de Node.js

Node.js se lanza con una cadencia predecible: los servicios de producción deben ejecutar versiones LTS Activas o de Mantenimiento, nunca las versiones principales impares de Current de corta duración.

Receta

Tarjeta de receta de referencia rápida - lista para copiar y pegar.

Cuándo usarlo:

• Elegir una imagen base para un nuevo microservicio
• Escribir un ADR para una actualización LTS
• Auditar si alguna flota todavía ejecuta Node con Fin de Vida útil
• Explicar a seguridad por qué las versiones Current están bloqueadas en producción

Ejemplo de trabajo

// src/health.ts - expone la conciencia LTS en las comprobaciones de salud
import { readFileSync } from 'node:fs';
 
const pkg = JSON.parse(readFileSync('package.json', 'utf8')) as {
  engines?: { node?: string };
};
 
export function healthPayload() {
  const major = Number(process.versions.node.split('.')[0]);
  const allowedMajors = [22, 24]; // Mantenimiento + LTS Activo
 
  return {
    status: allowedMajors.includes(major) ? 'ok' : 'degraded',
    node: process.version,
    enginesPolicy: pkg.engines?.node ?? 'not set',
    ltsPolicy: major === 24 ? 'active-lts' : major === 22 ? 'maintenance-lts' : 'unsupported',
  };
}

// package.json
{
  "engines": {
    "node": ">=24.18.0 <25 || >=22.23.1 <23"
  }
}

Lo que esto demuestra:

• Los puntos finales de salud pueden marcar tiempos de ejecución no LTS antes que los escáneres de seguridad
• engines puede expresar una ventana de migración intencional (22 y 24 concurrentemente)
• La versión principal se deriva de process.versions.node, no solo del análisis de la cadena process.version

Análisis Profundo

Cómo funciona

• Las nuevas versiones principales se lanzan cada abril y octubre (aproximadamente). Los números pares (22, 24, 26) entran en LTS; los números impares (23, 25) no.
• LTS Activo recibe características, correcciones de errores y parches de seguridad durante ~18 meses después de la promoción.
• LTS de Mantenimiento recibe solo correcciones críticas durante ~12 meses más, luego Fin de Vida útil.
• Current (versiones principales impares) es para los primeros adoptantes y autores de bibliotecas que prueban la compatibilidad.

Cronología del ciclo de vida (simplificada)

Notas de TypeScript

// Matriz de CI durante la migración LTS - prueba ambas líneas soportadas
const SUPPORTED_NODE_MAJORS = [22, 24] as const;
type SupportedMajor = (typeof SUPPORTED_NODE_MAJORS)[number];
 
function assertSupportedMajor(): SupportedMajor {
  const major = Number(process.versions.node.split('.')[0]) as SupportedMajor;
  if (!SUPPORTED_NODE_MAJORS.includes(major)) {
    throw new Error(`Unsupported Node major: ${major}`);
  }
  return major;
}

Errores comunes

• Desplegar node:latest o node:current - puedes terminar en una versión principal impar sin SLAs de seguridad. Solución: fija node:24.18.0-bookworm-slim.
• Permanecer en LTS de Mantenimiento después del EOL - el EOL de Node 20 significa que no hay parches CVE. Solución: recordatorios en el calendario 6 meses antes del EOL.
• Saltarse versiones LTS (20 → 24 sin probar en 22) - los cambios importantes se acumulan. Solución: actualiza a LTS Activo al menos un ciclo antes de que tu línea actual llegue al EOL.
• Tratar las versiones secundarias de semver como libres de riesgo - las versiones secundarias de LTS pueden deprecate APIs. Solución: ejecuta CI en cada lanzamiento de parche LTS.
• Ignorar la compatibilidad con npm - cada LTS de Node incluye una versión principal específica de npm. Solución: usa el npm incluido o documenta los pines de Corepack.

Alternativas

Preguntas Frecuentes

Relacionado

• Instalación y Gestión de Versiones - fnm, nvm y fijación de motores
• Node.js vs Bun vs Deno - contexto de ADR de tiempo de ejecución
• Mejores Prácticas Fundamentales de Node.js - lista de verificación de cumplimiento de LTS
• Antes/Después de la Actualización LTS de Node 20-24 - estudio de caso de migración

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