Next.js 16'da neler değişti?
Next.js 16, 21 Ekim 2025'te yayımlandı. Turbopack artık varsayılan derleyici, middleware.ts yerini proxy.ts'ye bırakıyor, params ve cookies() gibi isteğe bağlı API'ler asenkron olmak zorunda ve Cache Components ile önbellekleme tamamen isteğe bağlı bir modele geçiyor.
Resmi duyuruya göre yükseltmeden önce bakılması gereken yedi başlık var.
1. Node ve TypeScript için asgari sürümler
Next.js 16 Node.js 20.9 ve TypeScript 5.1 ister. Node 18 artık desteklenmiyor. Docker imajı Node 22 gibi güncel bir sürüm kullanıyorsa bu madde sorunsuz geçer, eski bir sürüm varsa ilk yapılacak iş imajı güncellemek.
2. Turbopack varsayılan oldu
Turbopack hem geliştirme hem üretim derlemesinde varsayılan. Resmi duyuru üretim derlemelerinde 2-5 kat, Fast Refresh'te 10 kata kadar hızlanma söylüyor. Özel webpack ayarı olanlar next build --webpack ile eski derleyicide kalabiliyor. Bunlar duyurudaki iddialar, gerçek kazanç projeye göre değişir, bu yüzden önce kendi projenizde ölçün.
3. params, cookies() ve headers() artık asenkron
Eşzamanlı erişim kaldırıldı, await zorunlu:
// Önce
export default function Page({ params }: { params: { slug: string } }) {
return <h1>{params.slug}</h1>
}
// Next.js 16
export default async function Page({ params }: { params: Promise<{ slug: string }> }) {
const { slug } = await params
return <h1>{slug}</h1>
}
Dinamik rotaları ve params.slug gibi erişimleri çok olan projelerde en çok dokunulacak yer burası.
4. middleware.ts, proxy.ts oldu
Dosyayı proxy.ts'ye, dışa aktarılan fonksiyonu proxy'ye çevirmek yeterli, mantık aynı kalıyor. Eski dosya adı Edge senaryoları için hâlâ çalışıyor ama kullanımdan kalkmış sayılıyor. Giriş kontrolünü bu katmanda yapan projeler için ilk test edilecek yer burası.
5. revalidateTag artık ikinci argüman istiyor
Tek argümanlı kullanım kullanımdan kalktı. Önbellek süresi profili vermek gerekiyor:
// Önce
revalidateTag('blog-posts')
// Next.js 16: arka planda tazeleme
revalidateTag('blog-posts', 'max')
// Server Action içinde, kendi yazdığını hemen görmek için
updateTag('blog-posts')
Bir formu kaydettikten sonra sitenin güncellenmesi bu çağrıya dayanıyorsa, o form için updateTag daha doğru görünüyor.
6. next lint kalktı
next lint komutu kaldırıldı ve next build artık lint çalıştırmıyor. ESLint'i doğrudan çalıştırmak gerekiyor, bunun için resmi bir codemod var. package.json'daki "lint": "next lint" satırını buna göre değiştirmek gerekir.
7. Cache Components isteğe bağlı
Önbellekleme artık varsayılan değil, cacheComponents: true ile açıyorsunuz ve "use cache" yönergesiyle neyin önbelleğe alınacağını siz seçiyorsunuz. Yükseltme sırasında kapalı bırakmak mantıklı. Önce yükseltmenin kendisi oturmalı, sonra önbellek stratejisi düşünülmeli.
Yükseltmeyi nasıl başlatmalı?
Resmi araç çoğu işi otomatik yapıyor:
npx @next/codemod@canary upgrade latest
Önerilen sıra: ayrı bir dalda codemod, sonra birim testleri ve uçtan uca testler, en sonda Docker imajı. Birden fazla ana sürüm atlanıyorsa her sürümün yükseltme notlarını sırayla okumak işi kolaylaştırır.
Sık sorulan sorular
Next.js 16 hangi Node sürümünü ister? En az Node.js 20.9. Node 18 desteklenmiyor.
middleware.ts hâlâ çalışır mı? Edge senaryoları için çalışıyor ama kullanımdan kalktı. Yeni ad proxy.ts.
Turbopack'i kapatabilir miyim? Evet, next dev --webpack ve next build --webpack eski derleyiciyi kullanır.

