Что такое модуль @nestjs/config и как управлять переменными окружения?

Модуль @nestjs/config

@nestjs/config — официальный модуль NestJS для управления конфигурацией. Под капотом использует dotenv для парсинга .env-файлов и предоставляет типобезопасный ConfigService.

Базовая настройка

// app.module.ts
import { ConfigModule } from '@nestjs/config';

@Module({
  imports: [
    ConfigModule.forRoot({
      isGlobal: true,       // доступен во всех модулях без реимпорта
      envFilePath: '.env',  // по умолчанию, можно передать массив
      cache: true,          // кэшировать process.env для производительности
    }),
  ],
})
export class AppModule {}

Использование ConfigService

@Injectable()
export class DatabaseService {
  constructor(private config: ConfigService) {}

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

Namespace-конфигурация (registerAs)

// config/database.config.ts
import { registerAs } from '@nestjs/config';

export default registerAs('database', () => ({
  host: process.env.DB_HOST ?? 'localhost',
  port: parseInt(process.env.DB_PORT ?? '5432', 10),
  name: process.env.DB_NAME ?? 'app',
}));

// app.module.ts
ConfigModule.forRoot({
  isGlobal: true,
  load: [databaseConfig],
});

// использование
const dbConfig = this.config.get('database');
// или через типизированный inject:
@Inject(databaseConfig.KEY) private db: ConfigType<typeof databaseConfig>

Валидация через Joi

import * as Joi from 'joi';

ConfigModule.forRoot({
  validationSchema: Joi.object({
    NODE_ENV: Joi.string().valid('development', 'production', 'test').required(),
    PORT: Joi.number().default(3000),
    DB_HOST: Joi.string().required(),
    JWT_SECRET: Joi.string().min(32).required(),
  }),
  validationOptions: {
    abortEarly: false, // показывать все ошибки сразу
  },
});

Множественные .env-файлы

ConfigModule.forRoot({
  envFilePath: [`.env.${process.env.NODE_ENV}`, '.env'],
});

Подводные камни

• Если isGlobal: false, каждый модуль обязан импортировать ConfigModule заново — распространённая причина ошибки "ConfigService not found".
• Все значения из process.env являются строками; config.get<number>('PORT') вернёт строку без явного преобразования — используйте parseInt или +.
• Порядок файлов в envFilePath имеет значение: первый найденный файл имеет приоритет, последующие не переопределяют уже установленные переменные.
• Переменные, уже присутствующие в process.env (из системы/Docker), не перезаписываются .env-файлом по умолчанию — это поведение dotenv.
• При использовании expandVariables: true для интерполяции ${VAR} порядок объявления переменных в файле важен.
• Валидация Joi происходит при старте приложения, но ошибки типа «переменная не задана» появятся только в runtime при первом config.get(), если нет схемы.
• Секреты (JWT_SECRET, API keys) не должны попадать в репозиторий через .env — используйте vault или secrets manager в production.

• Дает общий ответ про Node.js и не называет конкретные API NestJS.
• Не объясняет, где в lifecycle находится @nestjs/config и env vars.
• Не разделяет validation, authorization, business logic и persistence.
• Игнорирует ошибки, лимиты входных данных, observability и тестирование.

• Может объяснить @nestjs/config и env vars на примере кода.
• Называет ключевые API: ConfigModule, ConfigService.
• Использует точные API NestJS, а не вымышленные hooks/decorators/methods.
• Видит production-риски: безопасность, отказоустойчивость, логирование и тесты.