Tema 2 · App Factory & Config

2. Configuración Modular del Servidor: App Factory Pattern y Variables de Entorno

Separa la creación y middlewares de la aplicación (app.js) del arranque de la escucha de red (server.js) para facilitar tests de integración y validación tipada de variables de entorno.

Por qué separar app.js de server.js

Uno de los antipatrones más comunes en principiantes es ejecutar app.listen(PORT) en el mismo archivo donde se configuran los middlewares y rutas. Esta unión acopla el servidor HTTP al proceso físico del sistema operativo, dificultando la ejecución de suites de tests con Supertest.

1. Beneficios de la Separación de Archivos

app.js (La Aplicación Express)

Exporta la instancia de express() configurada con todos sus middlewares de seguridad, parsers y routers.

  • No abre puertos de red (sin listen()).
  • Es importado directamente por Supertest en los tests.
  • Inicia en milisegundos en entornos de prueba.
server.js (El Entrypoint de Producción)

Punto de entrada de Node.js (node server.js o administrado por PM2).

  • Valida las variables de entorno con Zod o Envalid.
  • Establece la conexión a la base de datos (PostgreSQL/Redis).
  • Inicia la escucha en el puerto mediante app.listen().
  • Captura señales POSIX (SIGTERM, SIGINT) para Graceful Shutdown.

2. Graceful Shutdown (Apagado Limpio)

Cuando un servidor VPS se reinicia o PM2 actualiza una versión sin caída (Zero Downtime Reload), el sistema operativo envía la señal SIGTERM. Una API profesional debe dejar de aceptar nuevas conexiones, terminar las peticiones en curso y cerrar ordenadamente el pool de conexiones a la base de datos antes de finalizar el proceso.

⚡ Separación app.js, server.js y Graceful Shutdown

Patrón Factory y orquestación de cierre seguro de conexiones.

server.js
Solo lectura
// ==========================================
// ARCHIVO: src/app.js (Exporta la app de Express)
// ==========================================
import express from 'express';
import helmet from 'helmet';
import cors from 'cors';

export function createApp() {
  const app = express();

  // Middlewares globales de seguridad y parseo
  app.use(helmet());
  app.use(cors({ origin: process.env.CLIENT_ORIGIN || '*' }));
  app.use(express.json({ limit: '10kb' })); // Previene ataques DoS con payloads gigantes

  // Healthcheck endpoint (esencial para balanceadores de carga y VPS)
  app.get('/health', (req, res) => {
    res.status(200).json({ status: 'ok', uptime: process.uptime(), timestamp: Date.now() });
  });

  return app;
}

// ==========================================
// ARCHIVO: src/server.js (Arranque y Graceful Shutdown)
// ==========================================
import { createApp } from './app.js';
import pg from 'pg';

const PORT = process.env.PORT || 3000;
const pool = new pg.Pool({ connectionString: process.env.DATABASE_URL });

const app = createApp();
const server = app.listen(PORT, () => {
  console.log(`[Express] Servidor escuchando en http://localhost:${PORT} en modo ${process.env.NODE_ENV}`);
});

// Manejo de Graceful Shutdown (Señales SIGTERM y SIGINT)
const shutdown = async (signal) => {
  console.log(`[System] Señal ${signal} recibida. Cerrando conexiones HTTP...`);
  
  server.close(async () => {
    console.log('[System] Servidor HTTP cerrado. Liberando pool de PostgreSQL...');
    try {
      await pool.end();
      console.log('[System] Pool de base de datos cerrado con éxito. Salida limpia.');
      process.exit(0);
    } catch (err) {
      console.error('[System] Error al cerrar pool:', err);
      process.exit(1);
    }
  });

  // Forzar apagado si las peticiones tardan más de 10 segundos
  setTimeout(() => {
    console.error('[System] Cierre forzado tras tiempo de espera agotado.');
    process.exit(1);
  }, 10000).unref();
};

process.on('SIGTERM', () => shutdown('SIGTERM'));
process.on('SIGINT', () => shutdown('SIGINT'));
🧠
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección
1 Pregunta
Pregunta 1
¿Cuál es la principal ventaja técnica de NO incluir app.listen() dentro del archivo app.js?
🦉
¿Tienes dudas con este tema?
Sócrates AI puede darte analogías y explicarte este código paso a paso.

🚀 ¿Quieres dominar Express.js: Framework Backend & APIs Empresariales y crear proyectos reales?

Aprende arquitectura limpia, desarrollo web moderno, buenas prácticas y despliegue en producción con nuestro Bootcamp Fullstack Developer con mentorías en vivo.

🏛️ Autoría y Propiedad Intelectual: Obra educativa original de Juan Sebastián Amador para Kilopolis Academia, estructurada sobre las especificaciones y estándares abiertos del W3C, el estándar vivo de WHATWG y la documentación oficial de código abierto. © Todos los derechos reservados.