Типовые проблемы
Ошибки, которые стоит знать наизусть, и что каждая означает.
Белая страница или 500
Сначала читайте storage/logs/laravel.log — там названо настоящее исключение.
Две самые частые причины на свежем сервере:
- Неверные доступы к базе. В ошибке будет
SQLSTATE[HY000] [1045]. - Файлы кэша принадлежат другому пользователю. Кэш, собранный от
root, недоступенphp-fpm, работающему подwww-data. Пересоберите от пользователя веб-сервера:
sudo -u www-data php artisan config:cache
sudo -u www-data php artisan route:cache
sudo -u www-data php artisan view:cache
Сайт открывается без стилей
Нет public/build или загрузка оборвалась. Распакуйте релизный архив заново: статика едет готовой, и манифест должен совпадать с файлами.
При бэкапе «mysqldump: command not found»
У веб-сервера другой PATH. Укажите каталог в .env:
DB_DUMP_BINARY_PATH=/usr/bin
Обновление падает с «No update-manifest.json»
Это полный релизный zip, а не пакет обновления. Полные zip нужны для свежей установки; обновления применяются из подписанного *-update-*.zip.
Обновление падает с «already exists»
Предыдущая попытка откатилась, но восстановление не удалило таблицы, созданные пакетом. Восстановите бэкап «до обновления» из Админка → Бэкапы и примените обновление снова. Текущий релиз стирает схему перед импортом, что убирает этот класс отказов; старые билды так не умели.
Загрузка файла падает с 413
nginx отбрасывает тело до того, как его увидит PHP:
client_max_body_size 64M;
Затем перезагрузите nginx.
Картинки загружаются, но не показываются
Не выполнен php artisan storage:link или public/storage указывает не туда. Удалите ссылку и создайте заново:
rm public/storage
php artisan storage:link
Тема активна, но витрина не изменилась
Исправлено в 1.2.0: на новых версиях Laravel view finder не синглтон, поэтому тема могла регистрировать свой путь в объекте, который уже выброшен. Обновитесь до 1.2.0 или новее; повторная активация темы применяет путь сразу.
API отдаёт 500 с ошибкой лимитера
Маршруты закэшированы без регистрации лимитеров. Исправлено в 1.1.1. На старых билдах выполните php artisan route:clear и не кэшируйте маршруты.
Не проходит активация лицензии
См. активация лицензии — там чек-лист про адрес API, исходящий доступ и значение domain_conflict.
Всё медленно под нагрузкой
По порядку: включите OPcache, переведите кэш и сессии в нормальное хранилище, затем смотрите на базу. Площадка с несколькими тысячами билетов в месяц спокойно живёт на 2 ГБ; медленная страница почти всегда неиндексированный запрос или отсутствующий кэш, а не сервер.
Как получить помощь
Напишите на support@scenecms.ru версию из Админка → Система, последние строки storage/logs/laravel.log и что вы делали прямо перед поломкой. Этого хватает, чтобы ответить на большинство обращений одним письмом.
Не нашли ответ?
Напишите на sales@scenecms.ru — отвечаем в течение рабочего дня.