¿Cómo manejas la configuración en NestJS?

Question

Accepted Answer

NestJS proporciona el paquete **`@nestjs/config`** para manejar configuración y variables de entorno de manera estructurada, type-safe e inyectable. Carga archivos `.env`, valida la configuración y pone los valores disponibles en toda la aplicación a través del `ConfigService` inyectable. ## Por qué es importante ```ts import { ConfigModule } from "@nestjs/config"; @Module({ imports: [ ConfigModule.forRoot({ isGlobal: true, // available app-wide without re-importing envFilePath: ".env", validationSchema: Joi.object({ // validate env vars at startup (fail fast) DATABASE_URL: Joi.string().required(), PORT: Joi.number().default(3000), JWT_SECRET: Joi.string().required(), }), }), ], }) export class AppModule {} ``` `ConfigModule.forRoot()` carga las variables de entorno (desde `.env` + el entorno del proceso) y — crucialmente — puede **validarlas** con un schema (Joi), así que una configuración faltante o inválida causa que la aplicación falle al iniciar con un error claro en lugar de fallar misteriosamente en tiempo de ejecución. ## Lectura de configuración vía ConfigService (inyectable) ```ts @Injectable() export class DatabaseService { constructor(private configService: ConfigService) {} // inject ConfigService connect() { const url = this.configService.get("DATABASE_URL"); const port = this.configService.get("PORT", 3000); // with a default } } ``` En lugar de leer `process.env` directamente en todas partes, inyectas `ConfigService` y llamas a `get()` — type-safe, testeable y centralizado. ## Configuración con namespaces/tipada ```ts // config/database.config.ts — group related config with registerAs export default registerAs("database", () => ({ host: process.env.DB_HOST, port: parseInt(process.env.DB_PORT, 10), })); // load it: ConfigModule.forRoot({ load: [databaseConfig] }) // access it: configService.get("database.host") ``` Los namespaces agrupan configuraciones relacionadas y mantienen la configuración organizada conforme crece. ## ¿Por qué no simplemente usar process.env directamente? ```text ✗ process.env scattered everywhere → hard to test, no validation, stringly-typed ✓ ConfigService → injectable (mockable in tests), validated at startup, typed, centralized — the structured NestJS way ``` ## Secretos y entornos ```text ✓ Keep secrets in .env (GITIGNORED) — commit a .env.example documenting required vars ✓ In production, inject config via the platform's env vars / secret manager ✓ Validate at startup so misconfiguration fails immediately with a clear message ``` ## Por qué es importante El manejo adecuado de la configuración es esencial para cualquier aplicación real — manejando URLs de bases de datos, claves API, puertos, secretos y feature flags de forma segura y flexible en diferentes entornos (desarrollo, staging, producción). El `@nestjs/config` de NestJS proporciona la forma estructurada e idiomática de hacerlo, y entenderlo es conocimiento importante de uso diario. Las ventajas clave sobre leer `process.env` directamente son significativas: el **`ConfigService`** inyectable hace la configuración testeable (mockeable en tests) y centralizada; la **validación al iniciar** (con un schema de Joi) detecta configuración faltante o malformada inmediatamente con un error claro en lugar de como una falla en tiempo de ejecución confusa y profunda en una solicitud; y los namespaces mantienen la configuración creciente organizada. Combinado con la mejor práctica de seguridad de mantener secretos en archivos `.env` ignorados por git (y un `.env.example` comprometido), esto te da una configuración segura, portable y validada. Saber cómo configurar `ConfigModule`, inyectar y usar `ConfigService`, y validar la configuración es fundamental para construir aplicaciones NestJS listas para producción y refleja práctica profesional de back-end.