NestJS fornisce il pacchetto @nestjs/config per gestire la configurazione e le variabili d'ambiente in modo strutturato, type-safe e iniettabile. Carica file .env, valida la config e rende i valori disponibili in tutta l'app tramite l'iniettabile ConfigService.
{ } ;
({
: [
.({
: ,
: ,
: .({
: .().(),
: .().(),
: .().(),
}),
}),
],
})
{}
ConfigModule.forRoot() carica le variabili d'ambiente (da .env + l'ambiente del processo) e — in modo cruciale — può validarle con uno schema (Joi), quindi una configurazione mancante o non valida fa crashare l'app all'avvio con un errore chiaro piuttosto che fallire misteriosamente a runtime.
@Injectable()
export class DatabaseService {
constructor(private configService: ConfigService) {} // inject ConfigService
connect() {
const url = this.configService.get<string>("DATABASE_URL");
const port = this.configService.get<number>("PORT", 3000); // with a default
}
}
Invece di leggere process.env direttamente ovunque, inietti ConfigService e chiami get() — type-safe, testabile e centralizzato.
// 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")
I namespace raggruppano le impostazioni correlate e mantengono la config organizzata man mano che cresce.
✗ 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
✓ 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
La corretta gestione della configurazione è essenziale per qualsiasi applicazione reale — gestire URL di database, API key, porte, secrets e feature flag in modo sicuro e flessibile tra gli ambienti (dev, staging, production).
Il @nestjs/config di NestJS fornisce il modo strutturato e idiomatico per farlo, e comprenderlo è una conoscenza quotidiana importante.
I principali vantaggi rispetto alla lettura diretta di process.env sono significativi: l'iniettabile ConfigService rende la config testabile (mockable nei test) e centralizzata; la validazione all'avvio (con uno schema Joi) cattura immediatamente la configurazione mancante o malformata con un errore chiaro piuttosto che come un fallimento confuso a runtime in profondità in una request; e i namespace mantengono la config in crescita organizzata.
Combinato con la best practice di sicurezza di mantenere i secrets in file .env gitignored (e un .env.example committato), questo ti fornisce una configurazione sicura, portabile e validata.
Sapere come configurare ConfigModule, iniettare e usare ConfigService e validare la config è fondamentale per costruire applicazioni NestJS production-ready e riflette le pratiche professionali di back-end.