NestJS tillhandahåller paketet @nestjs/config för att hantera konfiguration och miljövariabler på ett strukturerat, typsäkert och injicerbart sätt. Det laddar .env-filer, validerar config och gör värden tillgängliga i hela appen via den injicerbara ConfigService.
{ } ;
({
: [
.({
: ,
: ,
: .({
: .().(),
: .().(),
: .().(),
}),
}),
],
})
{}
ConfigModule.forRoot() laddar miljövariabler (från .env + processens miljö) och — mycket viktigt — kan validera dem med ett schema (Joi), så att en saknad eller ogiltig config orsakar att appen kraschar vid uppstart med ett tydligt felmeddelande istället för att misslyckas mysteröst vid körning.
@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
}
}
Istället för att läsa process.env direkt överallt injicerar du ConfigService och anropar get() — typsäkert, testbart och centraliserat.
// 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")
Namngivning grupperar relaterade inställningar och håller config organiserad när det växer.
✗ 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
Rätt konfigurationshantering är väsentlig för alla riktiga applikationer — hantering av databas-URLs, API-nycklar, portar, hemligheter och feature flags på ett säkert och flexibelt sätt över miljöer (dev, staging, production).
NestJS:s @nestjs/config tillhandahåller det strukturerade, idiomatiska sättet att göra detta, och förståelse för det är viktig vardaglig kunskap.
Nyckelfördelarna jämfört med att läsa process.env direkt är betydande: den injicerbara ConfigService gör config testbar (mockningsbar i tester) och centraliserad; validering vid uppstart (med ett Joi-schema) hittar saknad eller felaktig konfiguration omedelbar med ett tydligt felmeddelande istället för som ett förvirrande körtidsfel djupt i en request; och namngivning håller växande config organiserad.
I kombination med den säkerhetspraxis att hålla hemligheter i .gitignorerade .env-filer (och en committed .env.example), ger detta dig säker, portabel, validerad konfiguration.
Att veta hur man sätter upp ConfigModule, injicerar och använder ConfigService och validerar config är grundläggande för att bygga produktionsklara NestJS-applikationer och återspeglar professionell back-end-praktik.