Kegagalan hidrasi (hydration mismatch) pada aplikasi Server-Side Rendering (SSR) sering kali dianggap sepele sebagai ketidaksesuaian markup client-server. Namun, ketika proses Node.js mengalami crash fatal akibat Out-Of-Memory (OOM) atau memory corruption saat eksekusi renderToString, hydration error adalah gejala sekunder dari kebocoran state antar-request. Artikel ini membahas investigasi akar masalah menggunakan analisis post-mortem berbasis Linux core dump serta perbaikan arsitektur state SSR.
Anatomi Masalah: Singleton Leak dan Hydration Failure
Berbeda dengan client-side rendering (CSR) di mana satu runtime JavaScript menangani satu pengguna, runtime SSR Node.js melayani ribuan request konkuren dalam satu proses. Penggunaan module-level singleton atau closure yang tidak terisolasi akan menahan referensi state pengguna sebelumnya di memori heap V8.
Ketika akumulasi memory leak mendekati batas --max-old-space-size, alokasi memori untuk pohon VDOM gagal di tengah eksekusi renderToString(). Akibatnya, server mengirim markup parsial atau fallback kosong ke browser, memicu crash hidrasi fatal di sisi client sebelum proses backend terhenti (SIGABRT/SIGSEGV).
1. Konfigurasi OS untuk Menangkap Core Dump Node.js
Untuk melacak kondisi memori saat crash terjadi, sistem operasi Linux harus dikonfigurasi agar tidak memotong pembuatan core image.
# Izinkan core file tanpa batas ukuran untuk session berjalan
ulimit -c unlimited
# Konfigurasi systemd-coredump di /etc/systemd/coredump.conf
# Pastikan Storage bernilai persistent atau external
[Coredump]
Storage=persistent
Compress=yes
ProcessSizeMax=8G
ExternalSizeMax=8GJalankan proses Node.js dengan flag debugging native agar pointer simbol dan stack V8 tetap dipertahankan saat crash:
node --abort-on-uncaught-exception \
--max-old-space-size=2048 \
dist/server.js2. Membaca Core Dump Menggunakan coredumpctl dan LLDB
Setelah proses crash, gunakan coredumpctl untuk mengidentifikasi dan mengekstrak file core dump.
# Cari dump terbaru dari proses node
coredumpctl list node
# Ekstrak core dump ke file lokal
coredumpctl dump -o node_crash.core $(pgrep -n node)Gunakan LLDB untuk memeriksa stack trace level C++ dan V8 runtime:
lldb $(which node) -c node_crash.coreDi dalam shell interactive LLDB, periksa frame yang memicu sinyal terminasi:
(lldb) bt
# Frame yang menunjukkan V8 OOM biasanya memanggil v8::internal::V8::FatalProcessOutOfMemory
(lldb) thread list
(lldb) frame select 0
(lldb) register readUntuk tracing yang lebih granular pada JavaScript frame, muat plugin llnode (tersedia via npm atau build native):
(lldb) plugin load /usr/lib/llnode.so
(lldb) v8 bt
(lldb) v8 findrefs <address_of_leaked_object>3. Pola Kode Anti-Pattern vs Perbaikan
Penyebab umum memory leak pada SSR adalah mendaftarkan state request ke variabel lingkup modul (singleton scope).
Pola Rawan Bocor (Anti-Pattern)
// server.js - JANGAN LAKUKAN INI
import express from 'express';
import { renderToString } from 'react-dom/server';
import { App } from './App';
// Singleton state di modul: diakses dan menumpuk lintas request
const globalStore = [];
const app = express();
app.get('*', (req, res) => {
globalStore.push({ url: req.url, time: Date.now() }); // Leak terjadi di sini
const html = renderToString(<App store={globalStore} />);
res.send(`<div id="root">${html}</div>`);
});Pola Solusi: Isolasi Menggunakan AsyncLocalStorage
Gunakan modul standar node:async_hooks untuk membuat context isolation per-request tanpa perlu mem-passing instance secara manual ke seluruh layer fungsi rendering.
// context.js
import { AsyncLocalStorage } from 'node:async_hooks';
export const requestContext = new AsyncLocalStorage();
// server-fixed.js
import express from 'express';
import { renderToString } from 'react-dom/server';
import { App } from './App';
import { requestContext } from './context';
const app = express();
app.get('*', (req, res) => {
// Inisialisasi state bersih eksklusif untuk request ini
const perRequestStore = {
url: req.url,
user: null,
data: {}
};
requestContext.run(perRequestStore, () => {
try {
const html = renderToString(<App />);
// Kirim initial state ke window object agar client terhidrasi sempurna
res.send(`
<script>window.__INITIAL_STATE__ = ${JSON.stringify(perRequestStore)};</script>
<div id="root">${html}</div>
`);
} catch (err) {
res.status(500).send('Render Error');
}
});
});Verifikasi dan Sanitasi
Setelah menerapkan isolasi per-request:
- Jalankan load testing menggunakan tools seperti Autocannon atau K6 untuk memastikan footprint memori (RSS) tetap konstan setelah fase garbage collection.
- Pastikan state yang diserialisasi ke dalam HTML (
window.__INITIAL_STATE__) identik dengan state yang digunakan pada pemanggilanhydrateRoot()di browser untuk mengeliminasi silent hydration mismatch.
Komentar
0 komentar
Masuk ke akun kamu untuk ikut berkomentar.
Belum ada komentar
Jadilah yang pertama ikut berdiskusi!