Was ist der Unterschied zwischen Edge und Node.js runtimes?

Question

Accepted Answer

Next.js kann Servercode in zwei Runtimes ausführen. Die **Node.js runtime** (Standard) ist die vollständige Node-Umgebung; die **Edge runtime** ist eine leichte, auf V8 basierende Umgebung, die an weltweit verteilten Edge-Standorten in der Nähe von Benutzern läuft.

## Warum es wichtig ist

```ts
// per route handler / page
export const runtime = "edge";   // or "nodejs" (the default)
```

## Die Kompromisse

```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)
```

## Wann Edge verwenden

```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 zeichnet sich durch **leichte Logik aus, die von der Nähe zum Benutzer profitiert** und von sofortigen Cold Starts.

## Wann Node.js verwenden

```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)
```

## Ein reales Einschränkungsbeispiel

```ts
export const runtime = "edge";
import fs from "fs";           // ❌ not available on Edge — build/runtime error
import { PrismaClient } from "@prisma/client"; // ⚠️ needs HTTP/data-proxy on Edge
```

Viele populäre Bibliotheken (einschließlich ORMs, die rohe DB-Sockets öffnen) funktionieren auf Edge ohne einen HTTP-basierten Adapter nicht - eine häufige Fallstricke.

## Warum es wichtig ist

Die Wahl der Runtime ist eine echte Architekturentscheidung: **Edge** für schnelle, globale, leichte Logik (insbesondere Middleware) mit minimalen Cold Starts, **Node.js** für vollständigen API-Zugriff, direkte Datenbankverbindungen und schwere Arbeiten.

Die Kenntnis der Einschränkungen von Edge (nur Web APIs, kein rohes TCP, kurze Ausführung) verhindert den häufigen Fehler, datenbanklastige oder Node-abhängige Codes auf einer Runtime zu platzieren, die dies nicht unterstützen kann.