Lewati ke konten
Kelarin Proyek
19 November 2026

Laravel Error 500: Penyebab dan Solusinya

Panduan langkah demi langkah menelusuri Laravel error 500: baca log, cek .env, izin storage, cache konfigurasi, APP_KEY, dan versi PHP di server.

Error 500 di Laravel adalah pesan paling tidak membantu yang bisa kamu temui: ia hanya mengatakan bahwa sesuatu gagal di server, tanpa menyebut apa. Kabar baiknya, hampir semua kasus bisa dilacak dengan urutan yang sama. Artikel ini memandu langkah demi langkah, dari yang paling sering terjadi sampai yang jarang, lengkap dengan perintah yang bisa langsung kamu jalankan.

Langkah 1: baca log, jangan menebak

Laravel menulis detail setiap kesalahan ke berkas log. Di semua kasus, ini langkah pertama, karena pesan di sana biasanya langsung menunjuk penyebabnya.

tail -n 50 storage/logs/laravel.log

Cari baris yang diawali nama kelas pengecualian, misalnya Illuminate\Database\QueryException atau ErrorException, lalu baca pesan dan nama berkas serta nomor barisnya. Bila berkas log tidak ada atau kosong, itu sendiri petunjuk: kemungkinan besar Laravel tidak bisa menulis ke folder storage, dan kita akan membahasnya di langkah 3.

Untuk sementara di lingkungan pengembangan, kamu bisa menampilkan error langsung di layar dengan mengubah .env:

APP_ENV=local
APP_DEBUG=true

Jangan biarkan APP_DEBUG=true di server produksi. Halaman debug menampilkan jalur berkas, variabel lingkungan, dan potongan kode yang bisa membantu penyerang. Aktifkan sebentar untuk mendiagnosis, lalu kembalikan ke false.

Langkah 2: periksa berkas .env dan APP_KEY

Penyebab paling sering di server baru adalah .env yang hilang atau salah. Berkas ini biasanya tidak ikut diunggah karena masuk .gitignore, sehingga aplikasi berjalan tanpa konfigurasi database dan tanpa kunci enkripsi.

cp .env.example .env
php artisan key:generate

Pastikan nilai database sesuai dengan server, bukan dengan komputermu:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=nama_database
DB_USERNAME=nama_pengguna
DB_PASSWORD=kata_sandi

Jika APP_KEY kosong, Laravel melempar kesalahan No application encryption key has been specified, yang tampil sebagai 500. Menjalankan key:generate sekali sudah cukup. Jangan menggantinya setelah aplikasi dipakai pengguna, karena sesi dan data terenkripsi akan tidak terbaca.

Langkah 3: izin folder storage dan bootstrap/cache

Laravel perlu menulis log, sesi, cache tampilan, dan berkas unggahan. Bila pengguna yang menjalankan PHP-FPM atau Apache tidak punya izin tulis, kamu mendapat 500 tanpa log yang jelas.

sudo chown -R www-data:www-data storage bootstrap/cache
sudo chmod -R 775 storage bootstrap/cache

Nama pengguna www-data berlaku untuk Ubuntu dengan Nginx atau Apache. Di hosting bersama, pengguna biasanya sama dengan akun cPanel-mu, jadi cukup pastikan izin folder 775 lewat manajer berkas. Hindari chmod 777: itu membuka akses tulis ke semua pengguna di server dan sering dianggap solusi cepat padahal berbahaya.

Langkah 4: bersihkan cache konfigurasi yang basi

Setelah mengubah .env, perubahan tidak terbaca bila konfigurasi sudah di-cache. Ini jebakan klasik: kamu memperbaiki .env, tetapi error tetap sama.

php artisan optimize:clear

Perintah itu membersihkan cache konfigurasi, rute, tampilan, dan aplikasi sekaligus. Di produksi, setelah semuanya benar, bangun ulang cache untuk kecepatan:

php artisan config:cache
php artisan route:cache
php artisan view:cache

Satu peringatan penting: setelah config:cache, fungsi env() di luar berkas konfigurasi mengembalikan null. Selalu akses nilai lingkungan lewat config(), bukan env() langsung di kode aplikasi.

Langkah 5: cocokkan versi PHP dan ekstensi

Laravel bergantung pada versi PHP minimum tertentu dan beberapa ekstensi seperti mbstring, openssl, pdo_mysql, xml, ctype, dan fileinfo. Di komputer lokal semuanya ada, tetapi hosting murah kadang tidak.

php -v
php -m | grep -E "mbstring|openssl|pdo_mysql|xml|ctype|fileinfo"
composer install --no-dev --optimize-autoloader

Bila composer install mengeluh soal versi PHP, perbaiki versi PHP di panel hosting atau server, jangan memaksa dengan --ignore-platform-reqs karena itu hanya menyembunyikan masalah sampai aplikasi benar-benar dijalankan. Perhatikan pula bahwa folder vendor yang diunggah dari komputer dengan PHP berbeda bisa membawa paket yang tidak cocok. Lebih aman menjalankan composer install langsung di server.

Langkah 6: periksa koneksi database dan migrasi

Bila log menyebut SQLSTATE, masalahnya ada di database: kredensial salah, database belum dibuat, atau tabel belum dimigrasikan.

php artisan migrate --force
php artisan tinker
>>> DB::connection()->getPdo();

Perintah di tinker akan melempar pengecualian dengan pesan jelas bila koneksi gagal. Pesan Access denied berarti pengguna atau kata sandi salah, Unknown database berarti database belum dibuat, dan Connection refused biasanya berarti host atau port salah atau MySQL tidak berjalan.

Langkah 7: Nginx dan Apache, bukan hanya Laravel

Kalau halaman depan terbuka tetapi rute lain menampilkan 404 atau 500, web server mungkin belum meneruskan semua permintaan ke public/index.php. Pada Nginx, blok berikut wajib ada:

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

Pada Apache, pastikan mod_rewrite aktif dan berkas public/.htaccess ikut terunggah. Pastikan juga document root mengarah ke folder public, bukan ke akar proyek. Menaruh seluruh proyek di public_html membuat .env dan kode sumber bisa diunduh orang, dan itu masalah keamanan serius.

Daftar periksa singkat

Bila kamu terburu-buru, jalankan urutan ini:

  1. Baca storage/logs/laravel.log dan catat pesan sebenarnya.
  2. Pastikan .env ada dan APP_KEY terisi.
  3. Beri izin tulis ke storage dan bootstrap/cache.
  4. Jalankan php artisan optimize:clear.
  5. Cocokkan versi PHP dan ekstensi yang dibutuhkan.
  6. Uji koneksi database dan jalankan migrasi.
  7. Periksa konfigurasi Nginx atau Apache dan document root.

Sebagian besar kasus selesai di langkah 1 sampai 4. Sisanya biasanya soal lingkungan server, bukan kode aplikasi.

Kapan sebaiknya minta bantuan

Bila sudah menjalankan semua langkah dan error masih ada, kirimkan bahan yang lengkap: potongan log, versi PHP dan Laravel, dan langkah yang memicunya. Bahan yang baik mempercepat diagnosis dari jam menjadi menit. Untuk aplikasi tugas atau proyek yang butuh dikerjakan tanpa pusing, lihat layanan jasa Laravel atau perbaikan error kode. Jika masalahnya ada di pemasangan ke server, ada juga layanan deploy Laravel ke VPS. Siap menyerahkannya? Pesan di sini dan kita bahas lingkupnya lebih dulu secara gratis.

Punya proyek? Ngobrol dulu, gratis.