Sagiyo Blog

SOLVED: SQLSTATE[HY000] [2002] Connection refused

Anda yang menggunakan macOS, dan running migration biasanya akan muncul error ini. Yang menandakan bahwa Laravel tidak dapat terhubung ke database MySQL Anda.

Kamis, 03 Juli 2025 Pukul 15:29 WIB | Views: 7x

SOLVED: SQLSTATE[HY000] [2002] Connection refused

Anda yang menggunakan macOS, saat menjalankan perintah php artisan migrate atau php artisan migrate:fresh --seed, Anda mungkin pernah menemui error: SQLSTATE[HY000] [2002] Connection refused (Connection: mysql, SQL: select exists (select 1 from information_schema.tables where table_schema = schema() and table_name = 'migrations' and table_type in ('BASE TABLE', 'SYSTEM VERSIONED')) as `exists`). Error ini biasanya terjadi ketika Laravel gagal terhubung ke database MySQL. Secara normal, pesan Connection refused menunjukkan bahwa:

  1. MySQL server tidak berjalan atau tidak dapat diakses.
  2. Konfigurasi koneksi salah (host, port, username, password, atau nama database tidak valid di .env).
  3. Firewall/port terblokir, sehingga Laravel tidak bisa mengakses MySQL (default port: 3306).
  4. Database belum dibuat, padahal sudah dikonfigurasi di .env.

Intinya: Laravel mencoba memeriksa tabel migrations (untuk migrasi) tetapi gagal karena koneksi ke MySQL ditolak.


Namun sebelum melakukan pengecekan terhadap potensi isu yang disebutkan di atas, coba lakukan ini lebih dulu:

1. Tambahkan DB_SHOCKET mysql di file .env. Caranya adalah dengan membuka file .env dan tambahkan baris berikut: DB_SHOCKET=/Applications/MAMP/tmp/mysql/mysql.sock. Jika Anda tidak tahu dimana letak mysql.sock dan Anda menggunakan MAMP, Anda bisa menemukan link filenya dengan cara membuka halam utama webserver lokal Anda. Buka: http://localhost:8888/MAMP/ klik bagian MySQL.


2. Sesuaikan port MySQL yang Anda gunakan. Default port yang digunakan MySQL di MAMP adalah: 8889. Sesuaikan port ini pada pengaturan DB_PORT di file .env.


Kemudian jalankan perintah: php artisan migrate:fresh --seed. Selamat mencoba.



Artikel lainnya

Saatnya Beralih ke Ubuntu: Gratis, Aman, dan Andal!

Ubuntu hadir sebagai solusi gratis, aman, dan ramah pengguna. Cocok untuk kerja, coding, dan hiburan tanpa ribet dan tanpa biaya lisensi!

Selengkapnya

Saatnya Beralih ke Ubuntu: Gratis, Aman, dan Andal!

Laragon 6 vs Laravel Herd

Yang satu support berbagai framework, yang satunya khusus untuk Laravel. Yang satu memerlukan konfigurasi manual, yang satunya super ringan, serba otomatis, dan tampilan modern! Pilih mana?

Selengkapnya

Laragon 6 vs Laravel Herd