Что такое ConfigModule и ConfigService в NestJS?

ConfigModule и ConfigService в NestJS

При разработке приложений на NestJS часто требуется хранить чувствительные данные (ключи API, параметры базы данных, секреты) вне исходного кода — в переменных окружения. Пакет @nestjs/config предоставляет удобный способ работы с такими переменными.

ConfigModule

ConfigModule — это модуль, который нужно зарегистрировать в AppModule. Он отвечает за:

• Загрузку переменных из .env-файла с помощью библиотеки dotenv под капотом
• Их разбор и помещение в глобальный контекст приложения
• Опциональную валидацию через Joi или class-validator

Чаще всего его подключают с опцией isGlobal: true, чтобы не импортировать его заново в каждом модуле.

// app.module.ts
ConfigModule.forRoot({
  isGlobal: true,   // доступен во всех модулях без повторного импорта
  envFilePath: '.env',
})

ConfigService

ConfigService — это инжектируемый сервис, предоставляющий доступ к переменным окружения. Вместо прямого обращения к process.env рекомендуется использовать именно его, поскольку:

• Он поддерживает типизацию через дженерики
• Позволяет задать значение по умолчанию вторым аргументом
• Упрощает тестирование (можно замокать сервис)

// database.service.ts
@Injectable()
export class DatabaseService {
  constructor(private readonly configService: ConfigService) {}

  getConnectionString(): string {
    const host = this.configService.get<string>('DB_HOST', 'localhost');
    const port = this.configService.get<number>('DB_PORT', 5432);
    return `postgres://${host}:${port}`;
  }
}

Пространства имён (namespaces)

Для крупных приложений переменные можно группировать через фабричные функции конфигурации:

// database.config.ts
export default registerAs('database', () => ({
  host: process.env.DB_HOST || 'localhost',
  port: parseInt(process.env.DB_PORT, 10) || 5432,
}));

// database.service.ts
const dbConfig = this.configService.get('database');
console.log(dbConfig.host);

Валидация переменных окружения

Одна из важных возможностей — валидация переменных при старте приложения через Joi:

ConfigModule.forRoot({
  validationSchema: Joi.object({
    DB_HOST: Joi.string().required(),
    DB_PORT: Joi.number().default(5432),
    JWT_SECRET: Joi.string().min(16).required(),
  }),
})

Если какая-то обязательная переменная отсутствует, приложение выбросит ошибку ещё до запуска — это позволяет поймать проблему на этапе деплоя, а не в рантайме.

Итог

ConfigModule + ConfigService — стандартный способ управления конфигурацией в NestJS-приложениях, который обеспечивает чистую архитектуру, типобезопасность и удобное тестирование.