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 registrarConfigModule.forRoot({ isGlobal: true })enAppModule, 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 seaundefined.
⚡ Configuración Global con Validación Fail-Fast al Arrancar
Registro de ConfigModule.forRoot en AppModule e inyección segura de ConfigService:
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¿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.