NestJS fornece o pacote @nestjs/config para gerenciar configuração e variáveis de ambiente de forma estruturada, type-safe e injetável. Ele carrega arquivos .env, valida a configuração e disponibiliza valores em toda a aplicação via ConfigService injetável.
{ } ;
({
: [
.({
: ,
: ,
: .({
: .().(),
: .().(),
: .().(),
}),
}),
],
})
{}
ConfigModule.forRoot() carrega variáveis de ambiente (do .env + ambiente do processo) e — crucialmente — pode validar com um schema (Joi), então uma configuração ausente ou inválida quebra a app na inicialização com um erro claro em vez de falhar misteriosamente em tempo de execução.
@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
}
}
Em vez de ler process.env diretamente em todo lugar, você injeta ConfigService e chama get() — type-safe, testável e centralizado.
// 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")
Namespacing agrupa configurações relacionadas e mantém a configuração organizada conforme 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
Gerenciamento adequado de configuração é essencial para qualquer aplicação real — manipulando URLs de banco de dados, chaves de API, portas, secrets e feature flags de forma segura e flexível em diferentes ambientes (dev, staging, produção).
O @nestjs/config do NestJS fornece a forma estruturada e idiomática de fazer isso, e entendê-lo é conhecimento fundamental do dia a dia.
As principais vantagens sobre ler process.env diretamente são significativas: o ConfigService injetável torna a configuração testável (mockável em testes) e centralizada; validação na inicialização (com um schema Joi) captura configuração ausente ou malformada imediatamente com um erro claro em vez de como uma falha de runtime confusa em profundidade em uma requisição; e namespacing mantém a configuração crescente organizada.
Combinado com a best practice de segurança de manter secrets em arquivos .env ignorados pelo git (e um .env.example commitado), isso oferece configuração segura, portável e validada.
Saber como configurar ConfigModule, injetar e usar ConfigService e validar configuração é fundamental para construir aplicações NestJS prontas para produção e reflete prática profissional de back-end.