php artisan migrate ошибка: причины и исправление
Ошибка php artisan migrate означает, что Laravel не смог подключиться к базе данных или выполнить SQL из файла миграции. Сначала смотрите полный текст исключения в консоли: там указан драйвер, хост и код ошибки MySQL. Дальше проверяйте доступ к MySQL, параметры в .env и права на каталоги проекта.
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.
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.
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.
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. Выполните смену владельца и очистку кеша.
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.
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 нет новых исключений, миграция прошла успешно.
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, а в productionphp 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 снова.
Ещё по теме
- Ошибка · Деплой Ошибка 500 в Laravel: где искать причину и как исправить Разбираем ошибку 500 в Laravel: где смотреть логи, как проверить права на storage и bootstrap/cache, APP_KEY, синтаксис nginx и PHP-FPM. Команды для диагностики и…
- Ошибка · Деплой Ошибка composer install: как найти причину и исправить Разбираем ошибки composer install: нехватка памяти, права доступа, версия PHP. Команды для диагностики и исправления на Ubuntu 24.04 с nginx, PHP 8.3 и MySQL 8.
- Ошибка · Деплой Ошибка git pull permission denied на VPS: как исправить Разбираем ошибку git pull permission denied на VPS: проверка прав, SSH-ключей, владельца файлов и конфигурации nginx. Команды для диагностики и исправления.
- Ошибка · Деплой Ошибка 419 Page Expired в Laravel: причины и исправление Почему Laravel выдаёт 419 Page Expired: CSRF-токен, cookie сессии, SESSION_DOMAIN, кэш конфига. Как проверить и исправить каждую причину.
- Ошибка · Деплой Ошибка 413 Request Entity Too Large в nginx: как исправить Ошибка 413 в nginx: как найти лимит client_max_body_size, изменить его в конфиге, проверить PHP и перезапустить nginx. Команды и примеры.
- Руководство · Деплой Как развернуть сайт на VPS: Laravel и PHP на Ubuntu 24.04 Пошаговый деплой сайта на VPS: nginx, PHP 8.3, MySQL 8, git clone, composer install, миграции, права на storage и проверка через curl.
Деплой Laravel на сервер: команды, конфиг и ошибки: все материалы темы