Chào mọi người, sau các series Node.js cơ bản và Express framework, mình nhận được khá nhiều câu hỏi về cách tổ chức code khi ứng dụng Node.js lớn dần. Vì vậy mình sẽ viết series mới về NestJS 12.
Bài đầu tiên mình sẽ giới thiệu NestJS là gì, vì sao nên dùng, nó khác Express ở đâu, NestJS 12 có gì mới và project TaskFlow API mà chúng ta sẽ xây dựng trong suốt series.
1. NestJS là gì?
NestJS (hay Nest) là một framework để xây dựng các ứng dụng phía server bằng Node.js, được viết bằng TypeScript.
Bên dưới, NestJS không tự xử lý HTTP mà chạy trên một HTTP framework có sẵn: mặc định là Express, ngoài ra có thể đổi sang Fastify hoặc module node:http của Node.js. Các bạn vẫn có thể dùng trực tiếp các package của Express khi cần. Từ bản 12.3, tài liệu NestJS khuyên dùng Node adapter (@nestjs/platform-node, chạy thẳng trên node:http) cho ứng dụng mới và dự kiến đặt nó làm mặc định từ NestJS 13, nhưng series này vẫn giữ Express: đó là mặc định mà nest new đang sinh ra, có hệ sinh thái middleware và tài liệu cộng đồng lớn nhất, lại quen thuộc với các bạn đã học series Express.
Điểm khác biệt lớn nhất là NestJS cung cấp sẵn một kiến trúc cho ứng dụng. Theo tài liệu chính thức, Node.js có rất nhiều thư viện tốt nhưng không thư viện nào giải quyết được bài toán tổ chức code, và NestJS ra đời để làm việc đó. Kiến trúc này lấy cảm hứng nhiều từ Angular.
2. Vì sao nên dùng NestJS?
Với Express, các bạn tự quyết định đặt route, logic, kết nối database ở đâu. Project nhỏ thì không sao, nhưng khi nhiều tính năng và nhiều người cùng làm, mỗi người một kiểu sẽ rất khó bảo trì. NestJS giải quyết bằng ba thứ chính:
- Module: ứng dụng được chia thành các module theo tính năng (project, task, user...), mỗi module gom các thành phần liên quan lại với nhau.
- Dependency injection (DI): các class không tự khởi tạo những thứ chúng cần mà được NestJS tự động truyền vào. Nhờ vậy code ít phụ thuộc lẫn nhau và rất dễ viết test.
- TypeScript: kiểu dữ liệu giúp phát hiện lỗi ngay khi viết code, editor gợi ý tốt hơn và code dễ đọc hơn.
Ngoài ra NestJS có sẵn các package chính chủ cho những thứ backend nào cũng cần: validation, xác thực, queue, WebSocket, microservice, testing... Chúng ta sẽ lần lượt học các phần này trong series.
3. So sánh nhanh NestJS với Express.
Để thấy rõ sự khác nhau, mình sẽ viết cùng một API GET /api/v1/projects bằng cả hai.
VD1: Với Express (cách các bạn đã quen ở series Express).
- express-app.mjs
import express from 'express';
const app = express();
app.get('/api/v1/projects', (req, res) => {
res.json([{ id: 1, name: 'TaskFlow' }]);
});
app.listen(3000);
VD2: Với NestJS, đây là project một file do lệnh nest new --minimal tạo ra, mình chỉ sửa lại cho giống ví dụ trên. Các bạn chưa cần hiểu từng dòng, chỉ cần để ý cách code được chia thành các phần.
- src/main.ts
import { Controller, Get, Injectable, Logger, Module } from '@nestjs/common';
import { NestFactory } from '@nestjs/core';
// Service: nơi chứa logic xử lý dữ liệu
@Injectable()
class ProjectsService {
findAll() {
return [{ id: 1, name: 'TaskFlow' }];
}
}
// Controller: nhận request và trả về response
@Controller('api/v1/projects')
class ProjectsController {
constructor(private readonly projectsService: ProjectsService) {}
@Get()
findAll() {
return this.projectsService.findAll();
}
}
// Module: gom controller và service lại với nhau
@Module({
controllers: [ProjectsController],
providers: [ProjectsService],
})
class AppModule {}
const app = await NestFactory.create(AppModule);
await app.listen(3000);
const logger = new Logger('Bootstrap');
logger.log('TaskFlow API đã chạy', { port: 3000, env: 'local' });
Chạy Express bằng node express-app.mjs, NestJS bằng npm run start rồi gọi thử API, cả hai đều trả về cùng một kết quả:
curl http://localhost:3000/api/v1/projects
# [{"id":1,"name":"TaskFlow"}]
Như các bạn thấy, NestJS dài hơn khá nhiều. Đổi lại, mỗi phần có một chỗ cố định: ProjectsService lo dữ liệu, ProjectsController lo request, AppModule khai báo chúng thuộc về nhau, và controller nhận service qua constructor chứ không tự tạo (đó chính là DI). Response trả về cũng có header X-Powered-By: Express, vì bên dưới NestJS vẫn đang chạy Express.
Module, controller và provider (service) mình sẽ giải thích chi tiết ở Bài 4, 5 và 6. Tóm lại:
- Express phù hợp với các service nhỏ, ít route và sẽ giữ nguyên như vậy (proxy, webhook...).
- NestJS phù hợp với backend sẽ lớn dần: nhiều module, nhiều người làm, có database, job chạy nền...
4. NestJS 12 có gì mới?
NestJS 12.0.0 được phát hành ngày 27/08/2026, tại thời điểm viết bài bản mới nhất là 12.5. Để chạy ứng dụng NestJS 12 các bạn cần Node.js 20.19 hoặc 22.12 trở lên, còn dùng Nest CLI để tạo project thì cần Node.js 22.22.3, 24.15 hoặc 26 trở lên. Series này mình dùng Node.js 24 LTS và TypeScript 6.
ESM là mặc định.
Tất cả các package của NestJS 12 chuyển sang ESM (chuẩn import/export của JavaScript). Lệnh nest new giờ sẽ hỏi các bạn chọn project ESM hay CommonJS, và nếu chạy không tương tác thì mặc định là ESM. Project ESM có "type": "module" trong package.json, và import file trong project phải có đuôi .js (dù file gốc là .ts):
// Trích đoạn: import một file khác trong project ESM
import { AppModule } from './app.module.js';
Project cũ dùng CommonJS vẫn nâng cấp lên NestJS 12 được mà không phải đổi sang ESM. Series này sẽ dùng ESM từ đầu.
Vitest và oxlint.
Project ESM tạo mới dùng Vitest để viết test thay cho Jest (project CommonJS vẫn dùng Jest), và mọi project mới đều dùng oxlint để kiểm tra code thay cho ESLint. Chúng ta sẽ gặp oxlint ở Bài 3 và Vitest ở Bài 34.
Validation với Standard Schema.
Ngoài cách validate truyền thống bằng class và decorator (class-validator), NestJS 12 cho phép validate bằng các thư viện theo chuẩn Standard Schema như Zod, Valibot, ArkType. Các bạn khai báo schema qua option schema của @Body(), @Query(), @Param():
// Trích đoạn controller
const createProjectSchema = z.object({
name: z.string().min(3),
description: z.string().optional(),
});
type CreateProjectDto = z.infer<typeof createProjectSchema>;
@Post()
create(@Body({ schema: createProjectSchema }) body: CreateProjectDto) {
return body;
}
Khi đăng ký StandardSchemaValidationPipe, request gửi name ngắn hơn 3 ký tự sẽ nhận lỗi 400 với message name: Too small: expected string to have >=3 characters. Cả hai cách validate đều được hỗ trợ, mình sẽ hướng dẫn ở Bài 8.
Structured logging.
Logger có sẵn của NestJS giờ coi các object truyền sau message là dữ liệu đi kèm của cùng một dòng log, thay vì in thành các dòng riêng. Ở VD2, dòng logger.log(...) cuối file in ra:
[Nest] 57 - 11/15/2026, 5:19:53 AM LOG [Bootstrap] TaskFlow API đã chạy { port: 3000, env: 'local' }
Khi bật chế độ log JSON, các object này nằm trong key params, rất tiện để tìm kiếm trên các hệ thống quản lý log. Logging sẽ có ở Bài 26.
Ngoài ra NestJS 12 còn có tùy chọn phát hiện route bị trùng (Bài 5), mã lỗi errorCode cho exception (Bài 10), package @nestjs/observe để theo dõi ứng dụng... Danh sách đầy đủ các bạn xem tại migration guide.
5. Giới thiệu TaskFlow API.
Trong series này chúng ta sẽ vừa học vừa xây dựng TaskFlow API, phiên bản API (không có giao diện) của ứng dụng quản lý công việc TaskFlow trong series Laravel 13. Nếu đã theo series đó, các bạn có thể so sánh cách hai framework giải quyết cùng một bài toán.
TaskFlow API gồm các resource:
- User: người dùng, đăng nhập bằng JWT.
- Project: dự án, có
name,descriptionvà người sở hữu. - Task: công việc thuộc một project, có trạng thái
todo,doing,done, hạn hoàn thành và người được giao. - Tag: nhãn gắn cho task (quan hệ nhiều - nhiều) và Attachment: file đính kèm.
Các API đều nằm dưới /api/v1, VD: GET /api/v1/projects. Đến Bài 14 dữ liệu được lưu tạm trong bộ nhớ để tập trung vào các khái niệm của NestJS, từ Bài 15 chúng ta chuyển sang PostgreSQL với Prisma.
Để theo được series, các bạn cần biết JavaScript và Node.js cơ bản, biết Express là một lợi thế. Biết dùng terminal và Docker cơ bản sẽ giúp ích ở các bài về database.
6. Lời kết.
Như vậy mình đã giới thiệu với mọi người tổng quan về NestJS và NestJS 12: một framework có kiến trúc rõ ràng với module, DI và TypeScript, chạy trên Express. Vì NestJS dùng TypeScript ở khắp nơi, bài sau mình sẽ điểm qua những phần TypeScript cần biết trước khi học NestJS.
Đăng ký nhận tin.
Chúng tôi chỉ gửi tối đa 2 lần trên 1 tháng. Tuyên bố không spam mail!





0 Comments