Bạn thêm caching trong NestJS như thế nào?

Question

Accepted Answer

NestJS cung cấp một **module caching tích hợp** (`@nestjs/cache-manager`) với một API thống nhất hoạt động trên nhiều store — in-memory mặc định, hoặc **Redis** cho caching phân tán qua nhiều instance. Caching cải thiện hiệu năng đáng kể bằng cách tránh lặp lại công việc tốn kém.

## Thiết lập cache module

```ts
@Module({
  imports: [
    CacheModule.register({
      ttl: 60000,        // time-to-live mặc định (ms) — các entry hết hạn sau 60s
      max: 100,          // số item tối đa trong bộ nhớ (in-memory store)
      isGlobal: true,    // có sẵn toàn ứng dụng
    }),
  ],
})
export class AppModule {}
```

## Tự động cache endpoint với interceptor

```ts
@Controller("products")
@UseInterceptors(CacheInterceptor)   // tự động cache các response GET
export class ProductsController {
  @Get()
  @CacheTTL(30000)                    // override TTL cho route này
  findAll() {
    return this.productsService.findAll();   // kết quả được cache; các GET sau là tức thì
  }
}
```

`CacheInterceptor` tự động cache các response endpoint `GET` (khóa theo URL) và phục vụ kết quả đã cache cho các request lặp lại — cách đơn giản nhất để cache các endpoint nhiều đọc.

## Caching thủ công với CacheManager (nhiều kiểm soát hơn)

```ts
@Injectable()
export class ProductsService {
  constructor(@Inject(CACHE_MANAGER) private cache: Cache) {}

async getProduct(id: string) {
    const cached = await this.cache.get(`product:${id}`);   // kiểm tra cache trước
    if (cached) return cached;                               // cache HIT

const product = await this.db.findProduct(id);           // cache MISS — lấy
    await this.cache.set(`product:${id}`, product, 3600000); // lưu (TTL 1h)
    return product;
  }
}
```

Inject `CACHE_MANAGER` cho toàn quyền kiểm soát — pattern get-or-fetch (kiểm tra cache, dự phòng về nguồn, lưu kết quả) để cache các thao tác tốn kém cụ thể.

## Caching phân tán với Redis (nhiều instance)

```ts
CacheModule.registerAsync({
  useFactory: async () => ({
    store: await redisStore({ url: process.env.REDIS_URL }),   // dùng Redis làm store
    ttl: 60000,
  }),
});
```

Cùng API, được hỗ trợ bởi **Redis**, cho một cache **dùng chung** qua tất cả các instance ứng dụng — thiết yếu khi chạy nhiều instance (một cache in-memory không được chia sẻ giữa chúng).

## Phần khó: invalidate cache

```ts
async updateProduct(id: string, data) {
  await this.db.update(id, data);
  await this.cache.del(`product:${id}`);   // INVALIDATE khi thay đổi → tránh dữ liệu cũ
}
```

```text
Thách thức caching lớn nhất: INVALIDATION. Khi dữ liệu thay đổi, cache phải được
xóa/cập nhật, nếu không người dùng thấy dữ liệu cũ. Chiến lược: TTL (chấp nhận cũ ngắn),
xóa tường minh khi ghi (cache.del), hoặc cache tag.
```

## Tại sao điều này quan trọng

Caching là một trong những tối ưu hóa hiệu năng tác động cao nhất cho các ứng dụng back-end, và module caching tích hợp của NestJS làm cho nó sạch sẽ và nhất quán.

Hiểu nó là quan trọng vì các API nhiều đọc hưởng lợi to lớn từ việc cache các thao tác tốn kém (truy vấn database, lời gọi API bên ngoài, tính toán) — giảm đáng kể độ trễ và tải.

NestJS cung cấp cả auto-caching đơn giản (`CacheInterceptor` cho các endpoint GET) và kiểm soát thủ công chi tiết (pattern get-or-fetch của `CACHE_MANAGER` cho các thao tác cụ thể).

Quan trọng nhất, API thống nhất hoạt động với các store khác nhau, nên cùng code có thể dùng **caching in-memory** (nhanh, một instance) hoặc **Redis** (một cache dùng chung qua nhiều instance) — và biết rằng một cache in-memory *không được chia sẻ* khi scale ngang (cần Redis cho caching phân tán) là một điểm kiến trúc quan trọng.

Quan trọng không kém là hiểu khó khăn trung tâm của caching — **invalidation** (xóa hoặc cập nhật cache khi dữ liệu thay đổi, qua TTL hoặc xóa tường minh, để tránh phục vụ dữ liệu cũ) — vì làm sai cái này là thất bại caching kinh điển.

Biết cách và khi nào áp dụng caching, chọn store đúng cho việc triển khai, và xử lý invalidation đúng đắn là kiến thức cấp senior giá trị để xây dựng các service NestJS nhanh, có khả năng mở rộng.