Mejores Prácticas para Frameworks Ligeros
Un resumen condensado de las 25 prácticas más importantes para frameworks ligeros, extraídas de cada página de esta sección.
//
Busca en todas las páginas de la documentación
Un resumen condensado de las 25 prácticas más importantes para frameworks ligeros, extraídas de cada página de esta sección.
Por defecto, usa Hono para nuevos trabajos ligeros: Ecosistema activo, portable a edge - Conceptos Básicos de Hono.
No inicies nuevos proyectos Koa: Mantén los existentes; migra en la reescritura - Koa y Polka.
Usa el patrón de fábrica createApp(): Compartido entre los puntos de entrada de Node y edge.
Entrada de Node a través de @hono/node-server: No envolviendo node:http directamente.
Valida con Zod en los límites: @hono/zod-validator para entrada tipada.
app.onError() centralizado: JSON de error consistente.
Usa HTTPException para errores operacionales: 404, 401, 422 con códigos de estado.
Variables de contexto tipadas: c.set() / c.get() con genéricos.
Grupos de rutas antes de un archivo monolítico: app.route("/users", usersApp).
Middleware incorporado primero: hono/cors, hono/secure-headers, hono/logger.
Abstrae las APIs solo de Node: No uses node:fs en el código de la aplicación compartida - Hono en Node vs Edge.
Controladores de DB basados en HTTP en edge: Neon serverless, Supabase, Prisma Accelerate.
Prueba con app.request(): No se necesita enlazar un puerto.
Configuración del entorno a través de un parámetro de fábrica: No process.env en el código compartido.
Polka solo para micro-sidecars internos: < 5 endpoints, sin autenticación.
Agrega estructura antes de las 200 líneas: Divide en módulos de rutas temprano.
Ejecuta la lista de verificación de selección de framework: Antes de comprometerte - Lista de Verificación de Selección de Framework.
Registra ADR con fecha de revisión: 12 meses o con una carga 10 veces mayor.
No mezcles frameworks en un solo servicio: Un framework HTTP por desplegable.
Realiza un perfil antes de afirmar ganancias de tamaño: La E/S suele dominar sobre la elección del framework.
OpenAPI a través de @hono/zod-openapi: Documentación contract-first.
Orígenes CORS explícitos: Nunca uses comodines con credenciales.
Mantén los manejadores delgados: Lógica de negocio en funciones de servicio separadas.
Planifica la migración de Koa como un sprint: No incremental; reescribe las rutas.
Edge para latencia; Node para complejidad: Divide los servicios por necesidad de tiempo de ejecución, no por ideología.
Hono para nuevos proyectos. Fastify si necesitas el máximo rendimiento de Node. Express si la familiaridad del equipo es primordial.
En la próxima reescritura importante, sí. Para aplicaciones estables de bajo cambio, el costo de la migración puede no justificarse.
Por debajo de 3 endpoints en un puerto interno: HTTP puro está bien. Por encima de 5: usa Hono como mínimo.
Hono y Fastify pueden. A esa escala, considera NestJS para los límites de los módulos o impón convenciones estrictas para los archivos de rutas.
Grupos de rutas, capa de servicio, validación Zod y manejador de errores desde el primer día. Agrega estructura en el endpoint 10, no en el endpoint 50.
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.
Revisado por Chris St. John·Última actualización: 19 jul 2026