Website Jalan di Lokal tetapi Error Setelah Deploy: Cek dari Mana?

Aplikasi yang berjalan di laptop belum tentu berjalan dengan konfigurasi yang sama ketika dipublikasikan. Namun error setelah deploy tidak selalu berarti hosting bermasalah.

Sebelum mengedit konfigurasi, catat pesan error, URL yang gagal, dan revisi kode yang benar-benar terpasang di server.

1. Pastikan versi production

Bandingkan commit yang baru diuji dengan artifact atau build yang saat ini menjawab request. Jangan menganggap branch utama GitHub sama dengan aplikasi yang sedang berjalan.

Jika memakai worker, container, atau server biasa, cara membaca identitas rilisnya berbeda. Intinya tetap sama: cari bukti versi yang aktif.

2. Pisahkan build dari runtime

Build sukses membuktikan proses build selesai. Halaman dapat tetap gagal karena variable environment tidak tersedia, API salah konfigurasi, database tidak terhubung, atau asset path berbeda.

Kelompokkan error berdasarkan apakah muncul saat build, saat aplikasi memulai, ketika membuka halaman, atau hanya saat tindakan tertentu.

3. Periksa environment tanpa membuka secret

Periksa nama variable yang dibutuhkan dan apakah semuanya dikonfigurasi pada environment yang tepat. Tidak perlu menampilkan nilai token atau password ke log ataupun chat.

4. Tes jalur yang benar-benar penting

HTTP 200 pada homepage bukan bukti login, checkout, atau penyimpanan data bekerja. Gunakan data uji untuk alur penting, dan periksa error log baru setelah rilis.

Jika ada regresi kritis, hentikan rollout. Rollback hanya apabila versi sebelumnya diketahui baik dan data/schema masih kompatibel.

5. Perbaiki satu penyebab yang terbukti

Jangan memindahkan port, menghapus cache, atau menaikkan kapasitas server sebelum mengetahui apa yang gagal. Tindakan tersebut bisa menyembunyikan gejala sementara tanpa memperbaiki akar masalah.

Sebelum melakukan deploy berikutnya, mulai dari 3 Audit Fundamental untuk menilai struktur, login, dan hak akses pada project Anda.