IAli
Tüm Yazılar
React Server Components: Streaming SSR ve Hidrasyon Modeli Analizi

React Server Components: Streaming SSR ve Hidrasyon Modeli Analizi

RSC Flight formatı seri hale getirme protokolü, sunucu bileşenleri akışı, seçici hidrasyon maliyeti ve modern webde TTFB ile INP optimizasyonu.

Modern web uygulamalarında zengin kullanıcı arayüzleri inşa ederken istemciye gönderilen JavaScript kodunun boyutu sürekli büyüme eğilimi gösterir. Tek sayfa uygulamalarında (SPA) yaşanan beyaz ekran ve arama motoru optimizasyonu sorunlarına yanıt olarak geliştirilen geleneksel sunucu taraflı işleme (SSR), sorunu çözmeye çalışırken kendi yapısal sınırlarını üretmiştir. React 19 ile kararlı hale gelen React Server Components (RSC) ve streaming mimarisi, bileşen ağacının nerede çalışacağını ve tarayıcıya nasıl aktarılacağını yeniden tanımlar.

İncelemenin odağında geleneksel SSR hidrasyon darboğazları, React Flight veri akışı protokolü, HTTP chunk streaming ile Suspense sınırları, seçici hidrasyon (selective hydration) mekanizması ve bu tasarımın modern web performans metrikleri (TTFB, LCP, INP) üzerindeki ödünleşimleri yer almaktadır. Belirli bir çerçevenin dosya tabanlı yönlendirme ayrıntıları yerine React çekirdeğindeki veri akışı ve çalışma zamanı mekaniği analiz edilecektir.

Geleneksel SSR ve "Hep ya da Hiç" Darboğazı

Geleneksel sunucu taraflı işlemede süreç doğrusal ve birbirine bağımlı üç ana şelale (waterfall) adımıyla yürütülür:

  1. Sunucu tarafında veri şelalesi: Sunucu, sayfada render edilecek tüm bileşenlerin veritabanı veya harici API sorgularını tamamlamasını beklemek zorundadır. Yavaş yanıt veren tek bir veri kaynağı bile ilk baytın tarayıcıya ulaşma süresini (TTFB) geciktirir. Sunucu, ağacın tamamını oluşturmadan tarayıcıya tek bir bayt HTML gönderemez.
  2. İstemci tarafında paket şelalesi: Tarayıcı sunucudan gelen statik HTML içeriğini anında ekrana çizebilir (FCP). Ancak sayfanın etkileşim kazanabilmesi için o sayfada kullanılan tüm JavaScript kütüphanelerinin ve bileşen kodlarının indirilmesi gerekir.
  3. Senkron hidrasyon ve ana iş parçacığı bloklanması: JavaScript paketleri tarayıcıya ulaştığında React tüm bileşen ağacını baştan aşağı tek bir senkron görev halinde yürütür. DOM düğümleriyle sanal DOM ağacını eşleştirir ve olay dinleyicilerini (event listeners) bağlar.

Hidrasyon sırasında tarayıcının ana iş parçacığı (main thread) yüzlerce milisaniye kilitlenebilir. Sayfa görsel olarak hazır görünmesine rağmen kullanıcı bir butona tıkladığında veya bir forma yazı yazmak istediğinde arayüz tepki vermez. Bu durum zayıf bir Time to Interactive (TTI) ve kötü Interaction to Next Paint (INP) puanlarına yol açar.

React Server Components ve Flight Veri Protokolü

React Server Components, bileşenleri çalıştıkları ortama göre iki temel kategoriye ayırır: Sunucu Bileşenleri (Server Components) ve İstemci Bileşenleri (Client Components).

Sunucu bileşenleri yalnızca sunucu ortamında çalıştırılır ve JavaScript kodları istemci paketine dahil edilmez. Doğrudan veritabanı sürücülerine, dosya sistemine veya özel anahtarlara erişebilirler. Ağır veri ayrıştırma kütüphaneleri (örneğin Markdown işleyicileri veya tarih formatlayıcıları) sunucuda kalır.

Sunucu bileşenlerinin çıktısı istemciye düz HTML olarak değil, Flight adı verilen özel bir akış formatıyla aktarılır. React çekirdeğindeki ReactFlightServer paketi bileşen ağacını satır satır ayrılmış (newline-delimited) bir veri dizisine dönüştürür.

TEXT
0:I["./src/SearchInput.client.js",["default"],""]
1:{"name":"Dashboard","children":["$","div",null,{"className":"container","children":[["$","h1",null,{"children":"Raporlar"}],["$","$L0",null,{"placeholder":"Arama..."}],["$","$1:async_content",null,{}]]}]}
2:["$","table",null,{"children":["$","tr",null,{"children":["$","td",null,{"children":"Veri Satırı 1"}]}]}]

Yukarıdaki temsili Flight çıktısında yer alan anahtar semboller çalışma zamanı tarafından şu şekilde yorumlanır:

  • Satır başındaki sayılar chunk kimliğini belirtir.
  • I (Import): İstemci bileşeni referansıdır (Client Reference). Tarayıcıdaki ReactFlightClient çalışma zamanına ilgili JavaScript modülünü dinamik olarak içe aktarma talimatı verir.
  • $ sembolü: Bir React elementini temsil eder (Symbol.for('react.transitional.element')). Düğüm tipi, özellikleri ve çocukları JSON dizisi olarak taşınır.
  • $L0: Daha önce 0 numaralı satırda tanımlanan istemci bileşeni referansına işaret eden tembel (lazy) bağlantıdır.
  • Asenkron veri taşıyan kısımlar ise Promise referanslarıyla işaretlenir ve veritabanı yanıtı geldikçe yeni chunk satırları olarak akışa eklenir.

Mimari Veri Akışı Şeması

Aşağıdaki şema, bir RSC talebinde sunucu ile tarayıcı arasındaki eşzamanlı HTML akışı, Flight veri akışı ve hidrasyon adımlarını özetlemektedir:

TEXT
+-----------------------------------------------------------------------------+
|                          SUNUCU ÇALIŞMA ZAMANI                              |
+-----------------------------------------------------------------------------+
   |                                                    |
   | (renderToPipeableStream)                           | (ReactFlightServer)
   v                                                    v
[Statik HTML Kabuğu]                                 [Flight Veri Akışı]
(Hızlı ilk bayt, TTFB)                               (Satır satır JSON & Modül ID)
   |                                                    |
   | HTTP Yanıt Akışı                                  | HTTP Yanıt Akışı
   v                                                    v
+-----------------------------------------------------------------------------+
|                         TARAYICI ÇALIŞMA ZAMANI                             |
+-----------------------------------------------------------------------------+
   |                                                    |
   v                                                    v
[DOM Ağacı Çizimi]                                   [ReactFlightClient Parser]
(Ekranda iskelet fallback görünür)                   (İstemci modülleri indirilir)
   |                                                    |
   +------------------------+---------------------------+
                            |
                            v
               [Seçici Hidrasyon (Suspense)]
               (Yalnızca 'use client' bileşenleri
                bağımsız adalarda hidrate edilir)

HTML Streaming ve Suspense Sınırları

Sunucu tarafında renderToPipeableStream (Node.js ortamında) veya renderToReadableStream (Web Streams API destekli ortamlarda) kullanılarak HTML çıktısı parçalar halinde (chunked transfer encoding) tarayıcıya akıtılır.

Süreç Suspense sınırları üzerinden yürütülür:

  1. İlk Kabuk (Shell) Gönderimi: Sayfanın Suspense sınırları dışında kalan statik kısımları ve üst navigasyon alanı derhal oluşturulup ilk HTTP chunk olarak tarayıcıya yollanır. Tarayıcı içeriği anında ekrana basar. TTFB düşer.
  2. Fallback Render: Suspense sınırları içinde yer alan ve veri bekleyen dinamik bileşenler için sunucu geçici bir yükleme iskeleti (fallback) üretir. Bu iskelet DOM içinde özel bir işaretleyiciyle (örneğin <div id="S:0">...</div>) yer alır.
  3. Gecikmeli Veri ve Yer Değiştirme: Arka plandaki veritabanı sorgusu tamamlandığında, sunucu açık olan aynı HTTP bağlantısı üzerinden bir HTML şablonu (<template id="B:0">...gerçek içerik...</template>) ve küçük bir satır içi betik çağrısı gönderir.
  4. DOM Takası: Tarayıcı bu betiği çalıştırarak iskelet içeriği kaldırır ve yerine gerçek tablo veya liste içeriğini yerleştirir.

Kullanıcı tüm sayfanın yüklenmesini beklemeden hazır olan içerikleri incelemeye başlayabilir.

Seçici Hidrasyon ve Etkileşim Önceliklendirmesi

Geleneksel modelde hidrasyon tüm sayfa için tek bir blok halinde yapılıyordu. React 19 mimarisinde Suspense sınırları sayfayı izole hidrasyon adalarına böler. Bu mekanizmaya seçici hidrasyon (selective hydration) adı verilir.

Seçici hidrasyonun getirdiği iki temel kabiliyet şunlardır:

  • Bağımsız Hidrasyon: Sayfanın üst kısmında bulunan istemci bileşeni hidrate edilirken, alt kısımdaki henüz verisi tamamlanmamış Suspense bloğu beklenmez. Her istemci adası kendi kodu tarayıcıya ulaştığı anda hidrasyonunu tamamlar.
  • Etkileşim Önceliklendirmesi (Prioritized Hydration): Sayfada birden fazla istemci bileşeni olduğunu ve bunların sırayla hidrate edildiğini düşünelim. Kullanıcı henüz sırası gelmemiş bir bileşene (örneğin bir yorum kutusuna) tıkladığında React bu tıklama olayını yakalar. Yürütülmekte olan diğer hidrasyon görevlerini geçici olarak duraklatır ve kullanıcının etkileşime girdiği bileşeni acil öncelikle hidrate eder. Ardından kullanıcının yaptığı tıklamayı yeniden oynatır (event replay).

Kullanıcı arayüzde donma hissetmez. Ana iş parçacığındaki uzun süreli görevler (long tasks) daha küçük zaman dilimlerine bölünür.

Paket Boyutu Tasarrufu ile Ağ ve CPU Ödünleşimleri

React Server Components mimarisi belirgin kazanımlar sunarken bazı mimari ödünleşimleri de beraberinde getirir.

En belirgin kazanım istemci paket boyutundaki düşüştür. Ağır kütüphaneler sunucuda çalıştığı için tarayıcıya aktarılan JavaScript miktarı azalır. Ancak bu durum ağ bant genişliği kullanımının tamamen azaldığı anlamına gelmez.

Sunucudan gönderilen Flight veri akışı, bileşen ağacının JSON tabanlı serileştirilmiş halini taşır. Eğer sunucu bileşeni istemciye büyük veri listeleri veya derin nesne ağaçları gönderiyorsa, Flight veri yükü (payload) megabaytlar seviyesine ulaşabilir. Üstelik SSR sırasında hem üretilen HTML hem de istemcinin yeniden render edebilmesi için Flight verisi sayfaya gömülürse aynı veri ağ üzerinden iki defa taşınmış olur (double data passing).

Ayrıca tarayıcı tarafında ReactFlightClient ayrıştırıcısı gelen veri akışını parse ederken CPU harcar. Çok büyük ve karmaşık Flight yükleri istemci işlemcisini meşgul ederek zayıf cihazlarda sayfa yanıt sürelerini olumsuz etkileyebilir.

Web Metrikleri ve Üretim Kılavuzu

RSC ve streaming mimarisinin Core Web Vitals metrikleri üzerindeki yansımaları dikkatle yönetilmelidir:

  • TTFB (Time to First Byte): HTML kabuğunun erken gönderilmesiyle belirgin şekilde iyileşir. Ancak sunucu tarafında Suspense sınırlarının dışında ağır veri çağrıları bırakılırsa TTFB yine olumsuz etkilenir.
  • LCP (Largest Contentful Paint): Sayfanın en büyük içerik boyası bir Suspense bloğunun içindeyse ve bu veri geç geliyorsa LCP süresi uzayabilir. Kritik içerik ya ilk kabuk içine alınmalı ya da veri sorgusu optimize edilmelidir.
  • INP (Interaction to Next Paint): Seçici hidrasyon sayesinde ana iş parçacığı uzun süreli bloklamalardan kurtulur ve etkileşim gecikmeleri azalır.

Üretim ortamında yüksek performans elde etmek için şu kurallar gözetilmelidir:

  • 'use client' sınırları ağacın en tepesine değil, yalnızca etkileşim ve durum (state) gerektiren en uç yaprak bileşenlere (leaf components) yerleştirilmelidir.
  • Suspense sınırları mantıksal arayüz bloklarına göre dengeli dağıtılmalı, ne tüm sayfa tek bir sınıra hapsedilmeli ne de her küçük düğüm için ayrı bir sınır açılmalıdır.
  • Sunucu bileşenlerinden istemci bileşenlerine prop olarak yalnızca arayüzün ihtiyaç duyduğu alanlar aktarılmalı, gereksiz veritabanı alanları filtrelenmelidir.

Bileşen sınırlarını ve veri akışını doğru kurgulamak, modern web uygulamalarında düşük paket boyutu ile akıcı kullanıcı etkileşimini dengede tutmanın temel yoludur.

Yazıyı Değerlendir

0 tepki

Fikirlerinizi tek tıkla paylaşarak geri bildirim bırakın.

Bu teknik notu çevrenizle paylaşın

Ali Purtaş

@alipurtas • Hey, This is Ali!

İletişime Geç

Kendi halinde yazılım geliştiren bir öğrenci. Sistemler kuruyor, deniyor, bozuyor ve öğrendiği gerçek çözümleri burada belgeliyor.

Konu Kümesi & Önerilen Yazılar

İç Bağlantılı Mimari
Yorumlar yükleniyor...