Hydration error sering muncul saat mengimplementasikan simulasi self-replicating canvas seperti Conway's Game of Life, L-systems, atau model komputasi digital soup di framework SSR seperti Next.js. Masalah ini terjadi ketika struktur DOM atau state inisial yang dihasilkan server berbeda dengan yang di-render ulang oleh browser saat proses hidrasi.

Penyebab Utama: Rendering Non-Deterministik

Komponen simulasi visual berbasis grid sering memerlukan seed acak untuk populasi awal sel. Ketika inisialisasi state mengeksekusi fungsi non-deterministik seperti Math.random(), Date.now(), atau mengakses API browser seperti window.innerWidth pada fase render server, nilai yang dihasilkan di server Node.js dipastikan berbeda dengan nilai saat hidrasi di browser.

React membandingkan representasi VDOM hasil hidrasi dengan HTML statis kiriman server. Perbedaan status sel (hidup/mati) antara server dan client memicu Hydration failed because the initial UI does not match what was rendered on the server.

Contoh Masalah: Komponen Non-Deterministik

// BuggyCanvas.jsx (Menyebabkan Hydration Mismatch)
import React, { useState } from 'react';

const GRID_SIZE = 20;

function generateRandomGrid() {
  return Array.from({ length: GRID_SIZE * GRID_SIZE }, () =>
    Math.random() > 0.7 ? 1 : 0
  );
}

export default function BuggyCanvas() {
  // Math.random dieksekusi di Server dan Client secara independen
  const [grid] = useState(generateRandomGrid);

  return (
    <div className="grid-container">
      {grid.map((cell, idx) => (
        <span key={idx} className={cell ? 'alive' : 'dead'} />
      ))}
    </div>
  );
}

Solusi 1: Isolasi Penuh Menggunakan Dynamic Import (ssr: false)

Jika kanvas simulasi murni interaktif di client dan tidak memerlukan indexing konten oleh web crawler (SEO), pendekatan termudah dan terbersih adalah menonaktifkan SSR pada komponen tersebut. Ini mencegah server memproses state acak sama sekali.

// Page.jsx (Next.js App/Pages Router)
import dynamic from 'next/dynamic';

const CanvasComponent = dynamic(() => import('./CanvasSimulation'), {
  ssr: false,
  loading: () => <div className="canvas-skeleton">Memuat Simulasi...</div>,
});

export default function Page() {
  return (
    <main>
      <h1>Simulasi Digital Soup</h1>
      <CanvasComponent />
    </main>
  );
}

Solusi 2: Two-Pass Rendering Menggunakan useEffect

Jika dynamic import tidak diinginkan, gunakan pola two-pass rendering. Server merender representasi deterministik (misalnya grid kosong atau skeleton), lalu browser menginisialisasi state acak setelah event mount selesai.

// DeterministicCanvas.jsx (Memperbaiki Hydration Error)
import React, { useState, useEffect } from 'react';

const GRID_SIZE = 20;
const TOTAL_CELLS = GRID_SIZE * GRID_SIZE;

function generateRandomGrid() {
  return Array.from({ length: TOTAL_CELLS }, () =>
    Math.random() > 0.7 ? 1 : 0
  );
}

export default function DeterministicCanvas() {
  // Grid deterministik untuk render pertama (server & initial client)
  const [grid, setGrid] = useState(() => Array(TOTAL_CELLS).fill(0));
  const [isMounted, setIsMounted] = useState(false);

  useEffect(() => {
    // Dipanggil hanya di browser setelah hidrasi selesai
    setGrid(generateRandomGrid());
    setIsMounted(true);
  }, []);

  return (
    <div className="grid-container">
      {grid.map((cell, idx) => (
        <span
          key={idx}
          className={isMounted && cell ? 'alive' : 'dead'}
        />
      ))}
    </div>
  );
}
Trade-off Two-Pass Rendering: Komponen akan dirender dua kali pada initial load di client. Pendekatan ini dapat memicu visual flash jika tidak ditangani dengan placeholder atau transisi CSS yang tepat.

Alternatif: Seeded PRNG untuk Determinisme Server-Client

Jika server harus menghasilkan layout awal yang identik dengan browser, ganti Math.random() dengan algoritma Pseudo-Random Number Generator (PRNG) berbasis seed tetap (misalnya Linear Congruential Generator atau Mulberry32). Seed statis dikirimkan via props dari server ke client.

Checklist Audit Determinisme Render SSR

  • Bebas Entropi Acak: Pastikan tidak ada panggilan Math.random(), crypto.getRandomValues(), atau UUID dinamis langsung di level root komponen saat proses render awal.
  • Bebas Objek Global Browser: Pastikan tidak ada akses langsung ke objek window, document, atau localStorage di luar blok useEffect.
  • Sinkronisasi Temporal: Hindari kalkulasi waktu lokal seperti new Date().toLocaleString() di render path utama jika timezone server dan client berpotensi berbeda.
  • Validasi Struktur HTML: Pastikan penutupan tag HTML valid agar parser browser tidak merestrukturisasi elemen (seperti tag <p> di dalam <p> atau <tr> di luar <tbody>) yang dapat memicu mismatch hidrasi sekunder.