Sự khác biệt giữa Edge runtime và Node.js runtime là gì?

Question

Accepted Answer

Next.js có thể chạy code server trong hai runtime. **Node.js runtime** (mặc định) là môi trường Node đầy đủ; **Edge runtime** là một môi trường nhẹ, dựa trên V8, chạy ở các vị trí edge phân tán toàn cầu gần người dùng.

## Chọn một runtime

```ts
// theo từng route handler / page
export const runtime = "edge";   // hoặc "nodejs" (mặc định)
```

## Các đánh đổi

```text
                  Node.js runtime         Edge runtime
────────────────────────────────────────────────────────────────
APIs              full Node (fs, crypto,  Web APIs only (fetch,
                  Buffer, native modules) Request/Response) — limited
npm packages      all                     only those without Node APIs
Cold start        slower, heavier         near-zero, lightweight
Location          regional (one region)   global (near the user)
Latency to user   higher if far away      very low (geo-distributed)
Execution limits  longer, more memory     short CPU time, less memory
Database          direct TCP connections  HTTP-based DBs only (no raw TCP)
```

## Khi nào dùng Edge

```text
✓ Middleware (auth checks, redirects, geo-routing) — must be fast & global
✓ Simple, latency-sensitive endpoints (personalization, A/B, feature flags)
✓ Reading geolocation/headers to tailor responses
```

Edge tỏa sáng với **logic nhẹ được hưởng lợi từ việc ở gần người dùng** và từ cold start tức thì.

## Khi nào dùng Node.js

```text
✓ Direct database connections (Prisma over TCP, etc.)
✓ Heavy computation, large dependencies, native modules
✓ Anything using Node-specific APIs (fs, crypto.randomBytes via Node, Buffer)
```

## Một ví dụ ràng buộc thực tế

```ts
export const runtime = "edge";
import fs from "fs";           // ❌ không có trên Edge — lỗi build/runtime
import { PrismaClient } from "@prisma/client"; // ⚠️ cần HTTP/data-proxy trên Edge
```

Nhiều thư viện phổ biến (bao gồm các ORM mở socket DB thô) không hoạt động trên Edge nếu không có một adapter dựa trên HTTP — một cái bẫy phổ biến.

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

Chọn runtime là một quyết định kiến trúc thực sự: **Edge** cho logic nhanh, toàn cầu, nhẹ (đặc biệt là middleware) với cold start tối thiểu, **Node.js** cho truy cập API đầy đủ, kết nối DB trực tiếp và việc nặng.

Biết các hạn chế của Edge (chỉ Web API, không TCP thô, thực thi ngắn) ngăn ngừa lỗi thường gặp là đặt code nặng về database hoặc phụ thuộc Node lên một runtime không hỗ trợ được.