Redis Önbellekleme: Cache-Aside, TTL ve Invalidation

Bu rehberde ne öğreneceksiniz?

Bu yazı bir haber özeti değil; adım adım uygulayabileceğiniz bir öğretici makale (tutorial) formatındadır. Her bölümün sonunda pratik çıkarımlar ve üretim ortamında karşılaşacağınız senaryolar yer alır.

• Cache-aside pattern uygulamak
• TTL ve stampede önleme stratejisi seçmek
• Yazı güncellendiğinde tutarlı invalidation yapmak
• Redis'i session store olarak değerlendirmek

Ön koşullar

Rehberi verimli takip etmek için aşağıdaki bilgilere aşina olmanız önerilir. Eksik hissettiğiniz konularda ilgili bölümde ek kaynak ipuçları bulacaksınız.

• HTTP ve veritabanı latency kavramı
• Temel key-value düşüncesi
• REST veya Server Component data fetching

Güncellik ve teknoloji yığını

Makale 2026 itibarıyla güncellenmiştir. Örnekler ve API referansları şu yığınla uyumludur: Redis 7.x, Node ioredis, Next.js cache/revalidateTag. Eski sürüm dokümantasyonu ile karıştırmamak için major versiyon farklarını özellikle belirttik.

Framework sürümleri hızla değişir; kalıcı olan prensipler (güvenlik, katman ayrımı, ölçüm) bu rehberin omurgasını oluşturur.

Bölüm 1: Cache-aside akışı

1) Cache'e bak 2) Miss ise DB 3) Cache'e yaz 4) Döndür. Uygulama cache'i sahiplenir.

Adım adım uygulama

Aşağıdaki sırayı takip edin. Her adımı tamamlamadan bir sonrakine geçmeyin; özellikle güvenlik ve veri katmanı adımları atlanmamalıdır.

1. Redis bağlantısını singleton modülde yönetin.
2. Key isimlendirme convention: blog:list, blog:{id}.
3. TTL'i içerik türüne göre ayarlayın (liste kısa, detay orta).

async function getBlogList() {
  const cached = await redis.get('blog:list');
  if (cached) return JSON.parse(cached);
  const data = await getPublishedBlogs({});
  await redis.setex('blog:list', 300, JSON.stringify(data));
  return data;
}

Bölüm 2: Invalidation

Blog publish/unpublish/delete sonrası ilgili key'leri silin. Tag invalidation ile Next.js page cache'i de senkronize edin.

• Single blog: DEL blog:{id} + revalidatePath
• Liste: DEL blog:list
• Toplu: SCAN + pattern (dikkatli, production'da KEYS kullanmayın)

Bölüm 3: Stampede koruması

Hot key expire anında yüzlerce istek DB'ye gidebilir. Mutex veya probabilistic early refresh uygulayın.

Derinlemesine: Senaryo çalışması

Gerçek bir ekip senaryosu: Cuma akşamı deploy sonrası hata oranı yükseldi. Aşağıdaki kontrol listesi ile kök nedeni daraltın.

Son deploy diff'ine bakın: şema migration, env değişikliği, feature flag açılışı.

Trace id ile tek bir başarısız isteği uçtan uca izleyin (edge → server → DB).

Gerekirse kill switch veya önceki imaja rollback; veri migration geri alınamazsa kod rollback yeterli olmayabilir.

Adım adım uygulama

Aşağıdaki sırayı takip edin. Her adımı tamamlamadan bir sonrakine geçmeyin; özellikle güvenlik ve veri katmanı adımları atlanmamalıdır.

1. Metrik panosunda hata oranı ve p95 latency
2. Log'da son 15 dakika exception grupları
3. Son başarılı deploy tag'ine dönüş kararı

Production checklist

Canlıya çıkmadan önce bu maddeleri review edin.

Production ortamında üretim ortamı ile ilgili en sık görülen sorun, geliştirme ortamındaki varsayımların (küçük veri seti, tek kullanıcı, sıcak cache) canlı trafikte çökmemesidir. Bu yüzden her değişiklikten önce yük testi veya en azından p95 latency ölçümü yapın.

Structured logging (request id, route, süre, kullanıcı id’si — PII olmadan) ve hata oranı alarmları, sorunları kullanıcı şikayetinden önce yakalamanızı sağlar. Log’da stack trace tutun; kullanıcıya generic mesaj gösterin.

Dokümantasyonu kod ile birlikte güncelleyin: README, ADR (Architecture Decision Record) veya ekip wiki’sinde “neden bu kararı aldık?” sorusunun cevabı gelecekteki sizin en büyük yardımcınızdır.

• Rate limit ve timeout tanımlı
• Secret'lar secret manager'da
• Health check ve readiness probe çalışıyor
• Alarm eşikleri tanımlı (5xx, latency)

Sık yapılan hatalar

Aşağıdaki tuzaklar eğitim ortamlarında nadiren, production'da ise pahalıya mal olur. Code review checklist'inize eklemenizi öneririz.

• TTL olmadan cache büyümesi
• Invalidate etmeyi unutmak
• Hassas kullanıcı verisini paylaşımlı key'de tutmak

Pratik alıştırmalar

Okumak yeterli değildir; öğrenmeyi pekiştirmek için küçük bir side-project veya mevcut kod tabanınızda şu görevleri uygulayın:

1. Blog listesine 5 dk cache ekleyin; publish sonrası temizlendiğini doğrulayın
2. Cache hit oranını metric olarak loglayın

Özet ve sonraki adımlar

Bu rehberdeki prensipleri tek seferde tüm projeye uygulamaya çalışmayın. Önce tek bir route veya modül seçin, ölçün, sonra yaygınlaştırın.

• Redis Cluster dokümantasyonu
• CDN edge cache katmanı