Busca en todas las páginas de la documentación
Elegir Express 5, Fastify 5 o NestJS 11 configura la contratación, el rendimiento y la estrategia de pruebas durante años. Esta plantilla de ADR puntúa las opciones según las restricciones medibles del equipo, no según la religión del framework.
Tarjeta de receta de referencia rápida - lista para copiar y pegar.
# ADR-NNN: Framework HTTP para <Servicio>
## Estado
Propuesto | Aceptado | Sustituido por ADR-XXX
## Contexto
- Endpoints: N REST (+ GraphQL?)
- Equipo: M ingenieros, proceso de contratación
- SLO: latencia p95, pico de RPS
- Existente: ¿monolito Express 4? ¿paquete de autenticación compartido?
## Puntuación (1-5, peso entre paréntesis)
| Criterio | Peso | Express 5 | Fastify 5 | NestJS 11 |
| --- | --- | --- | --- | --- |
| Rendimiento / latencia | 25% | | | |
| Familiaridad del equipo | 20% | | | |
| Estructura a escala | 20% | | | |
| Ergonomía de las pruebas | 15% | | | |
| Ecosistema / middleware | 10% | | | |
| Costo de migración | 10% | | | |
| **Total ponderado** | | | | |
## Decisión
Usaremos <framework> porque <una frase>.
## Consecuencias
### Positivas
- ...
### Negativas
- ...
## Disparador de Revisión
Revisar cuando los endpoints > X o el p95 exceda Y bajo prueba de carga.Cuándo usar esto:
# ADR-003: Framework HTTP para la API de Pedidos
## Estado
Aceptado (2026-07-09)
## Contexto
- API de pedidos B2B: 42 endpoints REST, webhooks, sin GraphQL
- Equipo: 6 ingenieros, 2 familiarizados con Nest, 4 con Express
- SLO: p95 200ms en pico de 8k RPS; presupuesto de error 99.9%
- Servicio Greenfield; existe un plugin Fastify `@acme/auth` compartido
- Node 24.18.0, TypeScript 5.6, Postgres + Prisma
## Puntuación
| Criterio | Peso | Express 5 | Fastify 5 | NestJS 11 |
| --- | --- | --- | --- | --- |
| Rendimiento / latencia | 25% | 3 | 5 | 4 |
| Familiaridad del equipo | 20% | 4 | 3 | 3 |
| Estructura a escala | 20% | 2 | 4 | 5 |
| Ergonomía de las pruebas | 15% | 3 | 5 | 4 |
| Ecosistema | 10% | 5 | 4 | 4 |
| Costo de migración | 10% | 5 | 4 | 3 |
| **Ponderado** | | 3.35 | **4.30** | 3.95 |
## Decisión
**Fastify 5** con plugins modulares y `@acme/auth-fastify` compartido.
NestJS rechazado: la sobrecarga de DI no se justifica por debajo de 60 endpoints y no hay planes de división de microservicios.
## Consecuencias
### Positivas
- Pruebas `inject()` sin vinculación de puerto
- Validación de esquema JSON compilada al inicio
- Reutilización del plugin de autenticación interno de Fastify
### Negativas
- Los juniors aprenden la curva de encapsulación de plugins
- Menos respuestas en Stack Overflow que Express
- Contratación: especificar Fastify en la descripción del puesto
## Notas de Node.js
- Registro Pino incorporado; alinearse con el SDK OTel de la plataforma
- Ruta de migración de Express 5 documentada si una adquisición lo fuerza (candidato a sustitución de ADR)
## Disparador de Revisión
- Recuento de endpoints > 80 O un segundo equipo es propietario del mismo desplegable
- p95 > 250ms después de la optimización de la base de datos (no culpes al framework primero)Lo que esto demuestra:
| Criterio | Medida |
|---|---|
| Rendimiento | autocannon o k6 en hello-world + manejador JSON típico |
| Estructura | Módulos sin un app.ts monolítico; módulos Nest vs plugins Fastify |
| Pruebas | Velocidad de inject() / supertest; costo de mock de DI en Nest |
| Ecosistema | Passport, límite de velocidad, generadores OpenAPI que necesitas |
| Migración | Semanas-persona desde la base de código actual |
| Framework | Punto óptimo | Cuidado |
|---|---|---|
| Express 5 | Familiaridad, vasto middleware | Fácil de construir un monolito inmanejable |
| Fastify 5 | Rendimiento, primero el esquema | Curva de aprendizaje de encapsulación de plugins |
| NestJS 11 | Equipos grandes, monolito modular | Arranque en frío y sobrecarga de DI en APIs pequeñas |
| Alternativa | Usar Cuando | No Usar Cuando |
|---|---|---|
| Hono | Edge + API pequeña | Necesidades de DI pesadas al estilo Nest |
| tRPC | Monolito TS front+back | Se requiere un contrato de API REST público |
| Solo prueba de concepto, sin ADR | Desechable de 2 semanas | Servicio de producción |
Express 5 es la versión principal actual con enrutamiento mejorado y manejo de rechazo de promesas. Los nuevos ADRs deben citar Express 5 en Node 24.
Nest usa el adaptador de Fastify - resultado de ADR válido. Documenta la elección del adaptador en las Notas de Node.js.
El líder técnico es el autor; el EM reconoce el impacto en la entrega; el arquitecto de plataforma para la alineación de toda la organizació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.
Revisado por Chris St. John·Última actualización: 16 jul 2026