Geliştirme

Next.js 16'ya Geçmeden Önce Bilmeniz Gereken 7 Değişiklik

Mehmet Fatih Ünal
21 Ekim 2026
6 dk okuma
#Next.js 16#Turbopack#React 19#proxy.ts#Yükseltme
Next.js 16'ya Geçmeden Önce Bilmeniz Gereken 7 Değişiklik

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.

Daha Fazla İçerik

Blog sayfasında diğer yazılarımı keşfedin

Tüm Yazılar