Was macht Next.js 16 Launchpad?
Next.js 16: Turbopack als Standard (2-5× schnellere Builds), Cache Components ('use cache') und proxy.ts für explizite Steuerung.
Wann verwenden
✅ Next.js 16, Turbopack, Cache Components, Proxy-Migration, App Router, React 19.2
❌ Pages Router, Next.js ≤15, allgemeine React-Fragen
Voraussetzungen
| Tool | Version |
|---|---|
| Node.js | 20.9.0+ |
| TypeScript | 5.1.0+ |
| React | 19.2+ |
Schnellstart
# Neues Projekt
npx create-next-app@latest my-app
# Vorhandenes Upgrade
npx @next/codemod@canary upgrade latest
npm install next@latest react@latest react-dom@latest
Empfohlen: TypeScript, ESLint, Tailwind, App Router, Turbopack, @/*-Alias.
Minimal Setup
// app/layout.tsx
export default function RootLayout({ children }: { children: React.ReactNode }) {
return (
<html lang="en">
<body>{children}</body>
</html>
)
}
// app/page.tsx
export default function Page() {
return <h1>Hallo, Next.js 16!</h1>
}
Konfiguration
// next.config.ts
import type { NextConfig } from 'next'
const nextConfig: NextConfig = {
cacheComponents: true,
reactCompiler: true,
}
export default nextConfig
Änderungen v15 → v16
| v15 | v16 |
|---|---|
experimental.turbopack | Standard |
experimental.ppr | cacheComponents |
middleware.ts (Edge) | proxy.ts (Node) |
Synchrone params | await params |
Kernmuster
1. Server-Komponenten (Standard)
export default async function BlogPage() {
const res = await fetch('https://api.example.com/posts')
const posts = await res.json()
return <PostList posts={posts} />
}
2. Cache-Komponenten
import { cacheLife } from 'next/cache'
export default async function BlogPage() {
'use cache'
cacheLife('hours')
const posts = await fetch('https://api.example.com/posts').then(r => r.json())
return <PostList posts={posts} />
}
3. Client-Komponenten
'use client'
import { useState } from 'react'
export default function Counter() {
const [count, setCount] = useState(0)
return (
<div>
<p>Zähler: {count}</p>
<button onClick={() => setCount(count + 1)}>+</button>
</div>
)
}
4. Proxy-Grenze
// app/proxy.ts
export function proxy(request: NextRequest) {
if (!request.cookies.get('auth') && request.nextUrl.pathname.startsWith('/dashboard')) {
return NextResponse.redirect(new URL('/login', request.url))
}
return NextResponse.next()
}
5. Cache-Tags + Server-Aktionen
// app/blog/page.tsx
'use cache'
cacheLife('hours')
cacheTag('blog-posts')
export default async function BlogList() {
const posts = await db.posts.findMany()
return <PostList posts={posts} />
}
// app/actions.ts
'use server'
import { updateTag } from 'next/cache'
export async function createPost(data: PostData) {
await db.posts.create(data)
updateTag('blog-posts')
}
6. Streaming mit Suspense
export default function Dashboard() {
return (
<div>
<Suspense fallback={<Skeleton />}>
<RevenueCard />
</Suspense>
<Suspense fallback={<Skeleton />}>
<UsersCard />
</Suspense>
</div>
)
}
async function RevenueCard() {
const data = await db.analytics.revenue()
return <div>{data}</div>
}
Schlüsselkonzepte
- Turbopack – Rust-Bundler, inkrementelle Kompilierung, Fast Refresh
- Server-Komponenten – Standard in
app/, kein Client-JS - Client-Komponenten –
'use client', Hooks, Browser-APIs - Cache-Komponenten –
'use cache'+cacheLife()für PPR - Proxy-Grenze –
proxy.tsfür Authentifizierung/Rewrites/Redirects - Partielles Pre-Rendering – Statisches Gerüst + dynamisches Streaming
Migrations-Checkliste
-
Async-Request-APIs
npx @next/codemod@canary async-request-apiAktualisieren:
const { slug } = await params -
middleware.ts → proxy.ts
- Datei umbenennen,
proxyexportieren - Nur Node-Laufzeit (nicht Edge)
- Datei umbenennen,
-
Konfigurationsupdates
experimental.*-Flags entfernencacheComponents,reactCompileraktivierenserverRuntimeConfig/publicRuntimeConfigentfernen
-
Cache-Komponenten
experimental.pprdurchcacheComponents: trueersetzen- Dynamische Abschnitte mit
<Suspense>umschließen
-
Bilder
images.localPatternsfür Abfragezeichenfolgen konfigurieren
Siehe references/nextjs16-migration-playbook.md für die vollständige Anleitung.
Häufige Fallstricke
❌ 'use cache' mit Laufzeit-APIs (cookies(), headers()) mischen
❌ Fehlendes <Suspense> bei aktivierten Cache-Komponenten
❌ Tilde-Sass-Importe unter Turbopack
❌ proxy.ts auf Edge-Laufzeit ausführen
✅ Cookies/Header zuerst lesen, als Props an gecachte Komponenten übergeben
✅ Dynamische Kind-Elemente in <Suspense> einschließen
✅ Standard-Sass-Importe verwenden
✅ Node-Laufzeit für Proxy verwenden
Entscheidungsleitfaden
Cache-Komponenten aktivieren? → Ja für statische/semi-statische Inhalte → Nein für vollständig dynamische Dashboards
Wo lebt die Authentifizierung?
→ proxy.ts für routenübergreifende Prüfungen
→ Route Handler für API-spezifische Logik
Wann 'use client' verwenden?
→ Nur wenn Hooks, Zustand oder Browser-APIs benötigt werden
→ Präsentationskomponenten serverseitig belassen
Produktionsmuster
E-Commerce
// Produktseite mit Streaming
export default async function Product({ params }) {
const { id } = await params
const product = await db.products.findById(id)
return (
<>
<ProductInfo product={product} />
<Suspense fallback={<ReviewsSkeleton />}>
<Reviews productId={id} />
</Suspense>
</>
)
}
Authentifiziertes Dashboard
// proxy.ts
export function proxy(request: NextRequest) {
const session = request.cookies.get('session')
if (!session && request.nextUrl.pathname.startsWith('/dashboard')) {
return NextResponse.redirect(new URL('/login', request.url))
}
}
Weitere Vorlagen in references/nextjs16-advanced-patterns.md.
Leistung
- Turbopack aktiviert lassen (nur bei Bedarf mit
--webpackdeaktivieren) - Abrufe mit
Promise.allparallelisieren <Suspense>für Streaming-Grenzen verwenden- Dateisystem-Cache für große Repos aktivieren
Sicherheit
server-only-Paket + React-Taint-API verwenden- Authentifizierung in
proxy.tsbelassen - Eingaben in Server-Aktionen validieren
- Umgebungsvariablen mit
NEXT_PUBLIC_-Präfix versehen - Cookies/Header vor gecachten Bereichen extrahieren
Deployment
- Vercel: Zero-Config
- Docker/Node:
output: 'standalone' - Build-Zeiten überwachen (2-5× Beschleunigung erwartet)
- Cache-Lebenszyklen an CDN anpassen
Referenzdateien
- references/nextjs16-reference.md – Installation/Konfiguration/Checklisten
- references/nextjs16-migration-playbook.md – Migrationsanleitung mit Codemods
- references/nextjs16-advanced-patterns.md – Streaming-, Cache- und Authentifizierungsmuster
- references/NEXTJS_16_COMPLETE_GUIDE.md – Vollständige Dokumentation
- scripts/bootstrap-nextjs16.ps1 – Automatisiertes Setup-Skript
- assets/app-router-starter/ – Referenzimplementierung
Ressourcen
- Dokumentation: https://nextjs.org/docs
- GitHub: https://github.com/vercel/next.js
Version: 1.1.0 | Aktualisiert: 2025-12-27