Memahami gejala utama API Profil Pribadi Terputus Karena Cache Salah

Hal pertama yang terlihat adalah halaman personal site menampilkan nama, jabatan, atau foto lama padahal data backend sudah diperbarui. Ketika user mengirimkan update profil, response API sukses tetapi UI tetap menunjukkan versi lama. Inilah inti dari masalah: cache global memotong alur data terbaru sehingga API profil pribadi terputus karena cache salah. Filosofi "What should a personal website be?" menuntut konsistensi data, sehingga profile harus mencerminkan identitas aktual, bukan sekadar snapshot lama.

Kejadiannya: ada cache profil yang disimpan di edge cache atau Redis shared, dengan TTL cukup panjang. Saat data berubah, cache tidak dibersihkan atau dikonsolidasikan, sehingga permintaan berikutnya masih mendapatkan data lama. Dampaknya bukan hanya visual; pelanggan tidak percaya jika data tak sinkron dan API menjadi tidak dapat diandalkan.

Investigasi: log, metrik, dan root cause

Membuka log dengan request ID dan trace

Langkah awal: periksa log request API profiling. Pastikan setiap update memuat request ID unik. Log harus mencatat sebelum dan sesudah cache hit. Dari kasus ini ditemukan:

  • Update profil mendapat status 200, namun log cache menunjukkan hit walaupun TTL belum expired.
  • Header X-Cache menunjukkan HIT tanpa invalidasi.

Dengan request ID, trace menunjukkan bahwa saat update dijalankan, service cache tidak menerima event invalidasi.

Metrik observability untuk cache

Gunakan metrik hit rate cache, invalidation count, latency, dan error rate. Di kasus ini hit rate tinggi tetapi invalidation count tetap nol setelah dua hari deploy. Artinya, mekanisme invalidasi tidak terpanggil. Periksa juga trace distributed untuk melihat apakah event publishing berlangsung.

Root cause: cache global tanpa konsistensi per entitas

Cache di layer API Gateway menggunakan key statis misalnya profile:current. Ketika update dijalankan, service profil mengubah data di database namun tidak menghapus key tersebut karena tidak ada hook invalidasi. Akibatnya, semua permintaan setelah update tetap memuat payload lama sampai TTL habis.

Perbaikan: sinkronisasi cache dan API profil

Solusi jangka pendek dan panjang perlu dipikirkan. Pendek: tambahkan penghapusan cache saat update berhasil; panjang: gunakan cache key per user dan validasi versi.

Langkah 1 – Invalidasi cache saat update

Tambahkan hook invalidasi di service profil pribadi. Contoh sederhana (Node.js/Express dengan Redis):

async function updateProfile(req, res) {
  const userId = req.params.id;
  const payload = req.body;
  try {
    await db.update('profiles', userId, payload);
    await cache.del(`profile:${userId}`); // segera hapus cache
    res.status(200).send({ok: true});
  } catch (err) {
    res.status(500).send({error: 'Update gagal'});
  }
}

Dengan invalidasi langsung, cache tidak lagi menyajikan data usang. Perhatikan trade-off: operasi update kini menunggu penghapusan cache. Jika cache Redis down, fallback harus tetap dapat menangani update, mungkin dengan retries atau circuit breaker.

Langkah 2 – Cache berbasis kontrol versi

Untuk konsistensi lebih kuat, sertakan versi pada cache key, misal profile:{userId}:v{version}, dan simpan versi terakhir di database. Saat data berubah, increment versi dan cache baru otomatis dimuat saat permintaan berikutnya. Pendekatan ini menghindari race condition karena data lama tidak pernah dihidangkan.

Pengujian regresi dan monitoring untuk mencegah kambuh

Regression test

Buat test automatis yang melakukan siklus: update profil, fetch langsung, check bahwa cache invalidated. Jika menggunakan CI, tambahkan test yang memvalidasi header cache atau payload terbaru setelah update. Contoh pseudocode:

def test_profile_cache_invalidation():
    update_profile(user)
    response = fetch_profile(user)
    assert response['version'] == latest_version
    assert cache_get(f"profile:{user}") is None

Test ini memastikan cache tidak menghalangi data terbaru.

Monitoring berkelanjutan

Tambahkan alert pada metrik invalidation: jika hit rate tetap tinggi tanpa invalidasi, atau TTL habis tanpa update, perlu investigation. Juga pantau latensi update karena tambahan invalidasi bisa berdampak pada throughput.

Praktik tambahan

  • Gunakan cache-control header yang sesuai di API publik agar CDN atau browser tidak menyimpan data terlalu lama.
  • Masukkan ID aggregator atau change token di response untuk memastikan UI dapat mendeteksi versi usang.
  • Documentasikan perilaku cache agar tim lain tahu bahwa update profil memicu invalidasi.

Dengan kombinasi log trace, metrik observability, invalidasi langsung, dan regression test, bug API profil pribadi yang disebabkan cache salah bisa diselesaikan secara tuntas. Konsistensi data adalah janji terhadap personal branding, jadi pastikan sistem selalu menyampaikan versi diri yang paling aktual.