SQLSTATE[HY000] [2002] Connection refused Laravel Origin: Application & API Last updated 4 Nov 2026

Laravel: SQLSTATE[HY000] [2002] Connection refused (SQL: select * from sessions) / php_network_getaddresses: getaddrinfo failed

Laravel can't open a network connection to the database host and port from .env.

Exact message you may see SQLSTATE[HY000] [2002] Connection refusedSQLSTATE[HY000] [2002] php_network_getaddresses: getaddrinfo failed: Name or service not knownSQLSTATE[HY000] [2002] No such file or directorySQLSTATE[HY000] [2002] Connection timed outIlluminate\Database\QueryException SQLSTATE[HY000] [2002]
Explore the map of this error Full error map →
Seen on: Laravel PHP MySQL

Meaning

MySQL isn't running, DB_HOST/DB_PORT are wrong, or you're in Docker/Sail where the host is the service name (mysql), not 127.0.0.1. getaddrinfo failed means the host name doesn't resolve. Clear config cache after editing .env.

Common causes

  • MySQL not running or port blocked
  • Using 127.0.0.1 inside Docker (should be service name mysql or db)
  • Wrong DB_PORT (3306 vs mapped host port)
  • Hostname doesn't resolve (typo, Sail not up)
  • Cached config using old host

⚡ Quick fix

  1. Start MySQL: sudo systemctl start mysql
  2. In Sail: DB_HOST=mysql and ./vendor/bin/sail up -d
  3. php artisan config:clear

Detailed fix by platform

Linux

  1. nc -vz 127.0.0.1 3306 ; Sail: ./vendor/bin/sail ps

How to diagnose

  1. Server — Running?
  2. Host/port — Match environment?
  3. Docker — Service name used?

🔧 Still not fixed?

Many errors look alike. If the steps above didn’t solve it, one of these is probably what you’re facing:

Where this error sits

Origin: Application & API. Errors that are often confused with or caused by this one (click to open):

ConnectionRefusedError [Errno 111] (SMTP) — Python: ConnectionRefusedError: [Errno 111] Connection refused — smtplib connect to localhost:25 (Email / SMTP)ConnectionRefusedErro…Laravel: Allowed memory size exhausted (request) — Laravel/PHP: Allowed memory size of 134217728 bytes exhausted (tried to allocate 20480 bytes) in vendor/laravel/framework (Laravel)Laravel: Allowed memo…Nodemailer: ETIMEDOUT / ECONNECTION — Nodemailer: Error: connect ETIMEDOUT 142.250.27.108:465 (code: 'ETIMEDOUT', command: 'CONN') (Email / SMTP)Nodemailer: ETIMEDOUT…PDOException: could not find driver — Laravel: Illuminate\Database\QueryException: could not find driver (SQL: select * from information_schema.tables) (Laravel)PDOException: could n…Redis connection refused (Laravel) — Laravel: Predis\Connection\ConnectionException: Connection refused [tcp://127.0.0.1:6379] / RedisException: Connection refused (Laravel)Redis connection refu…Sail: getaddrinfo failed for host mysql — Laravel Sail: SQLSTATE[HY000] [2002] php_network_getaddresses: getaddrinfo for mysql failed: Temporary failure in name resolution (Laravel)Sail: getaddrinfo fai…SQLSTATE[23000]: Integrity constraint violation — Laravel: SQLSTATE[23000]: Integrity constraint violation: 1062 Duplicate entry 'x@example.com' for key 'users_email_unique' (Laravel)SQLSTATE[23000]: Inte…SQLSTATE[42S22]: Column not found — Laravel: SQLSTATE[42S22]: Column not found: 1054 Unknown column 'status' in 'field list' (Laravel)SQLSTATE[42S22]: Colu…SQLSTATE[…

Explore the map of this error Full error map →

🧠 Still stuck? Analyze your error

Paste the full message, response headers or stack trace — we'll detect the platform and point to the most likely cause.

💬 What worked for others

No tips yet — did something else fix this for you?

Share what worked for you

Tips are checked by an editor before they appear. Links are removed.