Tema 10 · ConfigModule & .env

10. Configuración con @nestjs/config, Validación de .env y Variables de Entorno Tipadas

Gestiona secretos y variables de entorno con ConfigService y valida que el servidor no arranque si faltan credenciales críticas al iniciar.

Gestión Profesional de Variables de Entorno en NestJS

Acceder directamente a process.env.DB_PASSWORD disperso por docenas de servicios dificulta las pruebas unitarias y puede causar fallos silenciosos en producción si alguien olvida definir una variable en el archivo .env del servidor VPS.

El paquete oficial @nestjs/config (que utiliza dotenv internamente) centraliza toda la configuración en un servicio inyectable (ConfigService) y permite validar el archivo .env al arrancar la aplicación.

npm i @nestjs/config

Buenas Prácticas de Configuración

  • isGlobal: true: Al registrar ConfigModule.forRoot({ isGlobal: true }) en AppModule, no necesitas volver a importarlo en cada módulo hijo.
  • Fallo temprano (Fail-Fast): Valida las variables requeridas (puerto, credenciales de base de datos, llave secreta JWT) al iniciar el servidor. Si falta una variable crítica, la aplicación debe detenerse con un mensaje claro antes de aceptar tráfico HTTP.
  • Tipado estricto: Usa configService.getOrThrow<string>('JWT_SECRET') para garantizar que el valor exista y nunca sea undefined.

⚡ Configuración Global con Validación Fail-Fast al Arrancar

Registro de ConfigModule.forRoot en AppModule e inyección segura de ConfigService:

src/app.module.ts
Solo lectura
import { Module } from '@nestjs/common';
import { ConfigModule, ConfigService } from '@nestjs/config';
import { CursosModule } from './cursos/cursos.module';

// Función nativa de validación Fail-Fast sin dependencias externas pesadas
function validarEntorno(config: Record<string, unknown>): Record<string, unknown> {
  const requeridas = ['DB_HOST', 'DB_NAME', 'DB_USER', 'JWT_SECRET'];
  for (const clave of requeridas) {
    if (!config[clave] || String(config[clave]).trim() === '') {
      throw new Error(`[ConfigModule] Falta la variable de entorno obligatoria: ${clave}`);
    }
  }
  return config;
}

@Module({
  imports: [
    ConfigModule.forRoot({
      isGlobal: true,           // Disponible en todos los módulos sin re-importar
      envFilePath: '.env',
      validate: validarEntorno, // Detiene el arranque si falta alguna credencial crítica
    }),
    CursosModule,
  ],
})
export class AppModule {}

/*
  Uso seguro en cualquier servicio con getOrThrow:
  const secreto = this.configService.getOrThrow<string>('JWT_SECRET');
*/
🧠
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 diferencia entre configService.get("JWT_SECRET") y configService.getOrThrow("JWT_SECRET") en @nestjs/config?
🦉
¿Tienes dudas con este tema?
Sócrates AI puede darte analogías y explicarte este código paso a paso.

🚀 ¿Quieres dominar NestJS Framework Profesional 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.