Next.js 16 Üretim Rehberi: App Router ve Cache

Next.js 16 üretim odağı

Next.js 16 ile App Router, cache semantics ve server action’lar varsayılan yol. 2026 üretim rehberi, next build çıktısını, route segment config’ini ve deployment hedefini (Node, serverless, edge) birlikte ele alıyor. Bu projede de Next 16 + React 19 strict TypeScript kullanıldığından, resmi node_modules/next/dist/docs/ belgeleri tek kaynak kabul edilmeli.

Cache ve invalidation

fetch cache, unstable_cache ve tag-based revalidation üretimde sık hata kaynağı. Stale içerik veya aşırı origin hit önlemek için tag stratejisi dokümante edilmeli. On-demand revalidate endpoint’leri secret ile korunmalı; aksi halde cache poisoning riski.

Güvenlik başlıkları

CSP, HSTS, X-Frame-Options middleware veya platform ayarlarıyla. Server action’larda CSRF koruması framework sürümüne bağlı; güncel patch takibi şart. Environment secret’lar yalnızca sunucuda; NEXT_PUBLIC_ ile sır taşınmamalı.

Observability

OpenTelemetry, request ID ve server timing header’ları SLA debug için. Edge ve Node runtime log formatı farklı; merkezi logda birleştir. Build ID ile release trace edilebilir olmalı.

Performans

Image optimizer, font subsetting ve RSC payload boyutu Core Web Vitals’ı etkiler. Lighthouse CI ve gerçek kullanıcı monitoring (RUM) birlikte. Partial Prerendering uygun sayfalarda değerlendirilir.

CI/CD

Lint, typecheck, test ve build pipeline zorunlu. Preview deployment’lar production secret’sız. Migration script’leri idempotent. Rollback: önceki container image veya platform revision.

Edge vs Node

Edge’de Node API’leri yok; veritabanı bağlantısı sınırlı. Ağır iş Node route handler’da. Karar matrisi latency vs capability.

Hata yönetimi

error.tsx ve not-found.tsx kullanıcı dostu; loglarda stack trace PII içermemeli. Global error boundary production’da generic mesaj.

Sonuç

Next.js 16 üretimde disiplinli cache, güvenlik ve gözlemlenebilirlik ister. Dokümantasyonla kod uyumsuzsa ikisi birlikte düzeltilmeli. Küçük, doğrulanabilir deploy’lar riski azaltır.