К содержимому

php artisan migrate ошибка: причины и исправление

Ошибка php artisan migrate означает, что Laravel не смог подключиться к базе данных или выполнить SQL из файла миграции. Сначала смотрите полный текст исключения в консоли: там указан драйвер, хост и код ошибки MySQL. Дальше проверяйте доступ к MySQL, параметры в .env и права на каталоги проекта.

Ошибка Деплой 3 мин чтения

01Неверные параметры подключения в.env

Самая частая причина: в .env указан не тот хост, порт, пользователь или пароль. Симптом: SQLSTATE[HY000] [2002] Connection refused или Access denied for user. Проверьте значения DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME, DB_PASSWORD и очистите кеш конфигурации, иначе Laravel продолжит читать старые значения из bootstrap/cache/config.php.

bash
cd /var/www/example.com
grep '^DB_' .env
php artisan config:clear
php artisan migrate --force

02Пользователь MySQL без прав на базу

Если в ошибке Access denied for user 'laravel'@'localhost', значит пользователь существует, но не имеет прав на нужную базу или вводит неверный пароль. Подключитесь как root и выдайте права на базу проекта. Для Laravel нужны как минимум SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, INDEX, DROP, REFERENCES.

sql
sudo mysql -u root
CREATE DATABASE IF NOT EXISTS example_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER IF NOT EXISTS 'laravel'@'localhost' IDENTIFIED BY 'strong_password';
GRANT ALL PRIVILEGES ON example_db.* TO 'laravel'@'localhost';
FLUSH PRIVILEGES;
EXIT;

03Служба MySQL не запущена или слушает другой сокет

Ошибка SQLSTATE[HY000] [2002] No such file or directory говорит о том, что PHP ищет сокет MySQL по неверному пути или сервер MySQL остановлен. Проверьте статус службы и путь к сокету. В Ubuntu 24.04 с MySQL 8 сокет обычно /var/run/mysqld/mysqld.sock, его можно указать в DB_SOCKET или в unix_socket секции mysql файла php.ini.

bash
sudo systemctl status mysql
sudo systemctl start mysql
mysqladmin --socket=/var/run/mysqld/mysqld.sock ping
php -i | grep -i 'pdo_mysql.default_socket'

04Нет прав на запись в storage и bootstrap/cache

При ошибке The stream or file "/var/www/example.com/storage/logs/laravel.log" could not be opened миграция падает ещё до SQL, потому что Laravel не может писать лог. Владельцем каталогов должен быть пользователь веб-сервера www-data, а права на запись нужны и консоли, и PHP-FPM. Выполните смену владельца и очистку кеша.

bash
cd /var/www/example.com
sudo chown -R www-data:www-data storage bootstrap/cache
sudo find storage bootstrap/cache -type d -exec chmod 775 {} \;
sudo find storage bootstrap/cache -type f -exec chmod 664 {} \;
php artisan optimize:clear

05Синтаксис SQL в файле миграции

Ошибка SQLSTATE[42000]: Syntax error or access violation с номером 1064 указывает на неверный SQL внутри файла миграции. В сообщении виден фрагмент запроса и имя файла. Откройте этот файл в database/migrations, исправьте запрос и выполните миграцию снова. Если миграция уже частично применилась, откатите её командой php artisan migrate:rollback --step=1.

bash
cd /var/www/example.com
php artisan migrate:status
php artisan migrate:rollback --step=1
php artisan migrate --force

06Как убедиться, что ошибка устранена

После исправления выполните миграцию и проверьте статус: все файлы должны быть в состоянии Ran. Затем перезапустите очередь и сбросьте кеш конфигурации, чтобы новые параметры подхватили и воркеры, и веб-запросы. Если приложение открывается и в логе storage/logs/laravel.log нет новых исключений, миграция прошла успешно.

bash
cd /var/www/example.com
php artisan migrate --force
php artisan migrate:status
php artisan optimize
php artisan queue:restart
tail -n 20 storage/logs/laravel.log

Что не помогает

  • Запуск php artisan migrate от root без --force в production: команда спрашивает подтверждение и в неинтерактивной сессии завершается без миграций.

    В production используйте php artisan migrate --force от пользователя www-data или из-под деплой-пользователя с правами на каталоги проекта.

  • Правка .env без php artisan config:clear: Laravel читает закешированный bootstrap/cache/config.php и продолжает подключаться по старым данным.

    После любого изменения .env выполняйте php artisan config:clear, а в production php artisan optimize для сборки нового кеша.

  • Выдача GRANT ALL ON *.* пользователю приложения, чтобы обойти ошибку доступа.

    Дайте права только на базу проекта: GRANT ALL PRIVILEGES ON example_db.* TO 'laravel'@'localhost'.

  • chmod -R 777 storage вместо смены владельца: права на запись получают все пользователи системы.

    Смените владельца на www-data:www-data и выставьте каталогам 775, файлам 664.

Deploykin

Как это делается в Deploykin

В Deploykin у каждого сайта свой системный пользователь и пул PHP-FPM, а команды в каталоге сайта выполняются от этого пользователя, поэтому права на storage и bootstrap/cache не расходятся. .env правится в панели, laravel.log читается там же, а об ошибке деплоя приходит оповещение.

7 дней бесплатно на тарифе Про, без привязки карты.

Вопросы и ответы

Почему php artisan migrate пишет Access denied for user при верном пароле?

Скорее всего, в .env другой пользователь или хост, либо в MySQL остался старый пароль. Проверьте DB_USERNAME и DB_HOST, затем выполните php artisan config:clear и повторите миграцию.

Что делать при ошибке SQLSTATE[HY000] [2002] Connection refused?

Проверьте, запущена ли служба: sudo systemctl status mysql. Если MySQL работает, сверьте DB_HOST и DB_PORT в .env с настройками сервера.

Можно ли запускать миграции от root?

Технически можно, но файлы кеша и логов получат владельца root, и PHP-FPM с www-data не сможет в них писать. Запускайте миграции от деплой-пользователя или www-data.

Как откатить неудачную миграцию?

Выполните php artisan migrate:rollback --step=1, чтобы откатить последний пакет. Затем исправьте файл миграции и запустите php artisan migrate --force снова.

Ещё по теме

Деплой Laravel на сервер: команды, конфиг и ошибки: все материалы темы

Мы используем cookies и сервис веб-аналитики «Яндекс Метрика» (включая Вебвизор) для улучшения работы сайта. Подробности — в политике конфиденциальности.