Bạn quản lý cấu hình trong NestJS như thế nào?

Question

Accepted Answer

NestJS cung cấp gói **`@nestjs/config`** để quản lý cấu hình và biến môi trường theo cách có cấu trúc, an toàn kiểu, và có thể inject. Nó tải các file `.env`, validate cấu hình, và làm cho các giá trị có sẵn khắp ứng dụng qua `ConfigService` có thể inject. ## Thiết lập ConfigModule ```ts import { ConfigModule } from "@nestjs/config"; @Module({ imports: [ ConfigModule.forRoot({ isGlobal: true, // có sẵn toàn ứng dụng không cần import lại envFilePath: ".env", validationSchema: Joi.object({ // validate env var lúc khởi động (fail fast) DATABASE_URL: Joi.string().required(), PORT: Joi.number().default(3000), JWT_SECRET: Joi.string().required(), }), }), ], }) export class AppModule {} ``` `ConfigModule.forRoot()` tải các biến môi trường (từ `.env` + môi trường process) và — quan trọng nhất — có thể **validate** chúng với một schema (Joi), để một cấu hình thiếu hoặc không hợp lệ làm crash ứng dụng lúc khởi động với một lỗi rõ ràng thay vì thất bại bí ẩn lúc runtime. ## Đọc cấu hình qua ConfigService (có thể inject) ```ts @Injectable() export class DatabaseService { constructor(private configService: ConfigService) {} // inject ConfigService connect() { const url = this.configService.get("DATABASE_URL"); const port = this.configService.get("PORT", 3000); // với một giá trị mặc định } } ``` Thay vì đọc `process.env` trực tiếp khắp nơi, bạn inject `ConfigService` và gọi `get()` — an toàn kiểu, dễ test, và tập trung. ## Cấu hình theo namespace/có kiểu ```ts // config/database.config.ts — nhóm các cấu hình liên quan với registerAs export default registerAs("database", () => ({ host: process.env.DB_HOST, port: parseInt(process.env.DB_PORT, 10), })); // tải nó: ConfigModule.forRoot({ load: [databaseConfig] }) // truy cập nó: configService.get("database.host") ``` Namespace nhóm các thiết lập liên quan và giữ cho cấu hình có tổ chức khi nó lớn dần. ## Tại sao không chỉ dùng process.env trực tiếp? ```text ✗ process.env rải rác khắp nơi → khó test, không validate, kiểu chuỗi (stringly-typed) ✓ ConfigService → có thể inject (mock được trong test), validate lúc khởi động, có kiểu, tập trung — cách NestJS có cấu trúc ``` ## Bí mật và môi trường ```text ✓ Giữ bí mật trong .env (ĐƯỢC GITIGNORE) — commit một .env.example tài liệu hóa các var cần thiết ✓ Trong production, inject cấu hình qua env var của nền tảng / trình quản lý bí mật ✓ Validate lúc khởi động để cấu hình sai thất bại ngay lập tức với một thông điệp rõ ràng ``` ## Tại sao điều này quan trọng Quản lý cấu hình đúng đắn là thiết yếu cho bất kỳ ứng dụng thực tế nào — xử lý các database URL, API key, port, bí mật, và feature flag một cách an toàn và linh hoạt qua các môi trường (dev, staging, production). `@nestjs/config` của NestJS cung cấp cách có cấu trúc, thành ngữ để làm điều này, và hiểu nó là kiến thức quan trọng hằng ngày. Các ưu điểm then chốt so với việc đọc `process.env` trực tiếp là đáng kể: **`ConfigService`** có thể inject làm cho cấu hình dễ test (mock được trong test) và tập trung; **validation lúc khởi động** (với một schema Joi) bắt cấu hình thiếu hoặc dị dạng ngay lập tức với một lỗi rõ ràng thay vì như một thất bại runtime khó hiểu sâu trong một request; và namespace giữ cho cấu hình lớn dần có tổ chức. Kết hợp với thông lệ bảo mật về việc giữ bí mật trong các file `.env` được gitignore (và một `.env.example` được commit), điều này cho bạn cấu hình an toàn, di động, đã được validate. Biết cách thiết lập `ConfigModule`, inject và dùng `ConfigService`, và validate cấu hình là nền tảng để xây dựng các ứng dụng NestJS sẵn sàng cho production và phản ánh thực hành back-end chuyên nghiệp.