NestJS предоставляет пакет @nestjs/config для управления конфигурацией и переменными окружения структурированным, типобезопасным и инъектируемым способом. Он загружает файлы .env, валидирует конфиг и делает значения доступными во всём приложении через инъектируемый ConfigService.
{ } ;
({
: [
.({
: ,
: ,
: .({
: .().(),
: .().(),
: .().(),
}),
}),
],
})
{}
ConfigModule.forRoot() загружает переменные окружения (из .env + окружение процесса) и — что важно — может валидировать их со схемой (Joi), поэтому отсутствующая или невалидная конфигурация приводит к краху приложения при запуске с понятной ошибкой, а не к загадочному отказу во время выполнения.
@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
}
}
Вместо прямого чтения process.env везде вы инъектируете ConfigService и вызываете get() — типобезопасно, тестируемо и централизованно.
// 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")
Пространства имён группируют связанные параметры и держат конфиг организованным по мере его роста.
✗ 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
Правильное управление конфигурацией — необходимо для любого реального приложения — обработка URL баз данных, API ключей, портов, секретов и флагов функций безопасно и гибко в разных окружениях (dev, staging, production).
NestJS @nestjs/config предоставляет структурированный, идиоматичный способ делать это, и понимание этого — важное повседневное знание.
Ключевые преимущества перед прямым чтением process.env значительны: инъектируемый ConfigService делает конфиг тестируемым (подменяемым в тестах) и централизованным; валидация при запуске (со схемой Joi) ловит отсутствующую или неправильно сформированную конфигурацию сразу с понятной ошибкой, а не как запутанный отказ во время выполнения глубоко в запросе; и пространства имён держат растущую конфиг организованной.
Вместе с практикой безопасности хранения секретов в игнорируемых .env файлах (и закоммиченном .env.example), это даёт вам безопасную, портативную, валидированную конфигурацию.
Знание того, как настроить ConfigModule, инъектировать и использовать ConfigService и валидировать конфиг, — основополагающее для построения production-ready NestJS приложений и отражает профессиональную back-end практику.