Поиск
Ошибки

Laravel: SQLSTATE[HY000] [2002] — Laravel не подключается к базе данных

Laravel берёт адрес базы данных, её имя, пользователя и пароль из файла .env. Ошибка со словом SQLSTATE значит, что подключиться не получилось: база не запущена, адрес или пароль неверные, базы нет или в ней нет таблиц. Номер в квадратных скобках подсказывает, что именно не так.

≈ 8 мин чтения
Содержание 13

Что сделать прямо сейчас

  1. Найдите в тексте ошибки номер в квадратных скобках после SQLSTATE[…] и откройте его разбор в таблице.
  2. Посмотрите настройки базы в файле .env: grep '^DB_' .env — в папке проекта.
  3. Проверьте, что база работает: sudo systemctl status mysql или sudo systemctl status postgresql.
  4. После правки .env выполните php artisan config:clear.

Команды вводятся на сервере: подключитесь к нему по SSH (как подключиться). В папке проекта лежат файл artisan и папки public и storage, например /var/www/example.com.

Как выглядит ошибка

SQLSTATE[HY000] [2002] … (Connection: mysql, Host: 127.0.0.1, Port: 3306, Database: laravel, SQL: select * from `sessions` where `id` = … limit 1)
ЧастьЧто значит
SQLSTATE[HY000]код ошибки по стандарту SQL; HY000 — «общая ошибка»
[2002]номер ошибки от MySQL — по нему ищут причину
… после номерапричина от системы или от базы данных
Connection: mysqlкакое подключение из настроек Laravel использовалось
Host, Port, Databaseкуда Laravel подключался — сверьте с .env
SQL: …какой запрос Laravel хотел выполнить

Запрос к таблице sessions в примере — не причина. В новом проекте Laravel сессии посетителей хранятся в базе, поэтому до базы Laravel обращается на любой странице, даже на главной.

Если в настройках задан сокет, вместо Host и Port в тексте стоит Socket: ….

Что значит номер в ошибке

Начало ошибкиЧто случилосьЧто делать
SQLSTATE[HY000] [2002]до MySQL не достучаться: база не запущена или адрес неверныйпроверьте DB_HOST и базу
[2002] php_network_getaddresses: getaddrinfo for … failedимя из DB_HOST не находитсяпоправьте DB_HOST
SQLSTATE[HY000] [1045] Access denied for userневерный пользователь или парольРазбор 1045
SQLSTATE[HY000] [1049] Unknown databaseбазы с таким именем нетРазбор 1049
SQLSTATE[42S02]: Base table or view not found: 1146база есть, таблиц нетвыполните миграции
SQLSTATE[08006] [7] connection to server atPostgreSQL не отвечает или не пускаетPostgreSQL
Database file at path [...] does not exist.нет файла базы SQLiteSQLite
could not find driverв PHP нет модуля для базыРазбор

Какие строки .env проверить

grep '^DB_' .env

Ответ для MySQL выглядит так:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel
DB_USERNAME=laravel
DB_PASSWORD=пароль
СтрокаЧто в ней
DB_CONNECTIONкакая база: mysql, mariadb, pgsql или sqlite
DB_HOSTадрес сервера базы; если база на этом же сервере — 127.0.0.1
DB_PORTпорт: 3306 у MySQL и MariaDB, 5432 у PostgreSQL
DB_DATABASEимя базы; у SQLite — путь к файлу
DB_USERNAME, DB_PASSWORDпользователь базы и его пароль

Если в пароле есть пробел или знак #, возьмите его в двойные кавычки: DB_PASSWORD="па#роль".

В новом проекте строки DB_HOST, DB_PORT и другие закомментированы — перед ними стоит #. Уберите #, иначе Laravel возьмёт значения по умолчанию: адрес 127.0.0.1 и базу с именем laravel.

Если правка .env не помогла

Если настройки закешированы командой php artisan config:cache или php artisan optimize, Laravel не читает .env. Обновите кеш:

php artisan config:clear

Если кеш настроек нужен, снова выполните php artisan config:cache — после правки .env каждый раз.

Если номер 2002

Laravel не достучался до MySQL. После [2002] стоит причина от системы: нет файла сокета или в подключении отказано.

  1. Проверьте, что MySQL работает: sudo systemctl status mysql. Если служба не работает — Active: failed или inactive, — запустите: sudo systemctl start mysql. Если не запускается, причину покажет sudo journalctl -u mysql -n 30.
  2. Сверьте DB_HOST и DB_PORT с тем, где MySQL принимает подключения: sudo ss -tlnp | grep 3306.

Чем отличаются localhost и 127.0.0.1 в DB_HOST:

DB_HOSTКак PHP подключаетсяРазбор ошибки
localhostчерез файл сокета на этом сервереMySQL 2002: Can't connect through socket
127.0.0.1по сети, на порт из DB_PORTMySQL 2003: Can't connect to MySQL server

Если сомневаетесь, поставьте DB_HOST=127.0.0.1.

Если в DB_HOST имя, а не адрес

SQLSTATE[HY000] [2002] php_network_getaddresses: getaddrinfo for mysql failed: …

В DB_HOST стоит имя, которого сервер не знает, — в примере mysql. Такое имя бывает в .env, скопированном с компьютера разработчика, где база работала в отдельном контейнере. На сервере укажите настоящий адрес базы: 127.0.0.1, если база на этом же сервере.

Если пишет Base table or view not found

SQLSTATE[42S02]: Base table or view not found: 1146 Table 'laravel.sessions' doesn't exist

К базе Laravel подключился, но таблиц в ней нет. Создайте их миграциями:

php artisan migrate --force

--force нужен, если в .env стоит APP_ENV=production: без него команда переспросит. Перед миграциями на рабочем сайте сделайте копию базы. Подробнее о самой ошибке — MySQL 1146: Table doesn't exist.

Если база PostgreSQL

Ошибка подключения к PostgreSQL начинается так:

SQLSTATE[08006] [7] connection to server at "127.0.0.1", port 5432 failed: …

Причина — после слова failed:.

После failedРазбор
в подключении отказаноPostgreSQL: Connection refused
password authentication failed for userPostgreSQL: password authentication failed
database "…" does not existPostgreSQL: database does not exist

Для PostgreSQL в .env стоит DB_CONNECTION=pgsql и DB_PORT=5432.

Если база SQLite

Database file at path [/var/www/example.com/database/database.sqlite] does not exist. Ensure this is an absolute path to the database.

Файла базы SQLite нет по указанному пути. В новом проекте Laravel база по умолчанию — SQLite, файл — database/database.sqlite. Создайте файл и таблицы:

touch database/database.sqlite
php artisan migrate --force
sudo chown -R www-data:www-data database

Последняя команда отдаёт папку database пользователю сайта: SQLite пишет служебные файлы рядом с базой, поэтому писать нужно и в саму папку. Если папку не отдать, SQLite ответит attempt to write a readonly database.

Если в DB_DATABASE путь указан вручную, он должен начинаться с / — от корня диска.

Ошибки и как их исправить

Что видитеПричинаЧто делать
SQLSTATE[HY000] [2002]MySQL не запущен или неверный DB_HOSTпроверьте базу и адрес
getaddrinfo for … failedв DB_HOST имя, которого нетпоставьте адрес
[1045] Access denied for userневерный парольРазбор
[1049] Unknown databaseнет базыРазбор
Base table or view not foundне выполнены миграцииphp artisan migrate
SQLSTATE[08006] [7]PostgreSQL не пускаетPostgreSQL
Database file at path [...] does not exist.нет файла SQLiteсоздайте файл
attempt to write a readonly databaseу www-data нет записи в папку databaseотдайте папку www-data
поправили .env, ошибка та женастройки закешированыphp artisan config:clear
could not find driverнет модуля PHP для базыРазбор

Тексты сообщений сверены по исходному коду Laravel 13.42.0 и PHP 8.3.6.

Источники

Сверено 13 ноября 2026 года.

Где проверить исправление. Если ошибка случилась на рабочем сайте, исправление спокойнее сначала проверить на отдельном тестовом VPS с Ubuntu, например в Timeweb Cloud Реклама. АО «ТАЙМВЭБ», ИНН 7810353960. erid: CQH36pWzJpoBWKF332yG5h2XQ4cVubfBmkvqAitFqcpzWs. Как зайти на него после заказа — в статье Как подключиться к VPS по SSH.

Что почитать дальше