Cara Menangani Error 404, 500 dan Custom Error Page di Laravel

Pendahuluan

Bayangin lagi ngerjain fitur sederhana, tapi tiba-tiba user nemu halaman putih polos dengan tulisan 'Whoops' atau malah pesan error teknis yang nggak estetik sama sekali. Jujur, ini musuh utama kita sebagai developer karena bikin user merasa aplikasi kita nggak niat atau bahkan nggak aman. Di Laravel, nanganin error page itu sebenarnya lebih dari sekadar ganti tampilan, ini soal ngasih feedback yang sopan ke user supaya mereka nggak langsung tutup tab.

Tips & Best Practices

• Di banyak project, biasanya saya mulai dari bikin satu base template error yang konsisten dengan desain UI aplikasi supaya user nggak merasa 'dibuang' ke dunia lain saat error terjadi.
• Saat nentuin strategi logging, saya selalu pastiin kalau error 500 wajib masuk ke log atau external tracker kayak Sentry, sedangkan 404 cukup kita pantau frekuensinya buat lihat apakah ada broken link yang harus diperbaiki.
• Pernah saya kejadian user bingung pas kena 404 karena nggak ada navigasi balik, jadi sekarang saya selalu selipin tombol 'Kembali ke Home' atau kolom pencarian di setiap halaman error.

Contoh Kode

Laravel sudah nyiapin direktori resources/views/errors. Kamu cukup buat file dengan nama sesuai kode statusnya. Contoh, buat custom 404 yang ramah user:

<!-- resources/views/errors/404.blade.php -->
<div class="text-center">
    <h1>Yah, Halaman Nggak Ketemu</h1>
    <p>Mungkin link-nya salah atau halamannya udah pindah.</p>
    <a href="/">Balik ke Home aja yuk!</a>
</div>

Variasi Implementasi

Ada dua pendekatan utama di sini. Pertama, pakai view statis di folder errors yang simpel buat error default. Kedua, kalau mau lebih advance, kamu bisa modifikasi Handler.php (atau di bootstrap/app.php untuk Laravel 11+) buat nangkep exception tertentu dan redirect user atau ngirim notifikasi ke Slack kalau error-nya masuk kategori critical. Biasanya, buat aplikasi enterprise, pendekatan kedua ini wajib biar tim ops gercep kalau ada server yang crash.

Kesalahan Umum

• Lupa nyalain APP_DEBUG=false di environment production, jadinya stack trace malah muncul di depan mata user.
• Terlalu banyak ngasih info teknis di halaman 500, padahal user cuma butuh tahu kalau kita lagi berusaha benerin masalahnya.
• Nggak ngetes halaman error pas lagi mode development, akibatnya pas launching dan ada error, malah tampilannya berantakan.
• Malah redirect semua error ke homepage, ini bikin user bingung karena mereka nggak tahu kalau halaman yang dituju sebenarnya bermasalah.
• Cuma bikin file 404 dan 500 saja, padahal masih banyak status lain kayak 403 atau 419 yang sering ditemuin user pas sesi login habis.

Ringkasan

Nangani error itu bukan cuma soal teknis, tapi soal empati ke user. Laravel udah ngasih kemudahan luar biasa, jadi nggak ada alasan buat biarin user ketemu halaman error yang bikin panik. Dengan sedikit sentuhan desain dan logika penanganan yang tepat, pengalaman user tetap terjaga meski kondisi aplikasi lagi kurang fit.