Ошибки OpenCart
Белый экран OpenCart и fatal error: как искать причину без паники
Что делать, если OpenCart показывает белый экран или fatal error: логи, PHP, OCMOD, шаблон, модуль, кеш, резервная копия и порядок исправления.
Белый экран почти всегда означает, что выполнение PHP прервалось до вывода страницы. Причина может быть простой, но исправлять такую ошибку лучше по шагам: зафиксировать лог, понять источник и проверить связанные сценарии.
Причины
Почему появляется проблема
несовместимость модуля с версией PHP
Эту причину нужно проверять по логам, настройкам и связанным сценариям магазина, а не только по внешнему виду страницы.
ошибка в шаблоне после правки
Эту причину нужно проверять по логам, настройкам и связанным сценариям магазина, а не только по внешнему виду страницы.
конфликт OCMOD/VQMod
Эту причину нужно проверять по логам, настройкам и связанным сценариям магазина, а не только по внешнему виду страницы.
поврежденный кеш модификаторов
Эту причину нужно проверять по логам, настройкам и связанным сценариям магазина, а не только по внешнему виду страницы.
нехватка памяти или проблема на хостинге
Эту причину нужно проверять по логам, настройкам и связанным сценариям магазина, а не только по внешнему виду страницы.
Что проверить сначала
Частые ошибки при самостоятельном исправлении
| Ошибка | Почему это опасно |
|---|---|
| включать display_errors на боевом сайте надолго | Можно скрыть симптом, но оставить причину: после следующего заказа, очистки кеша, обновления модуля или обхода робота ошибка вернется. |
| удалять модуль без понимания его таблиц и настроек | Можно скрыть симптом, но оставить причину: после следующего заказа, очистки кеша, обновления модуля или обхода робота ошибка вернется. |
| исправлять только видимую страницу, не проверив корзину и оплату | Можно скрыть симптом, но оставить причину: после следующего заказа, очистки кеша, обновления модуля или обхода робота ошибка вернется. |
Безопасный порядок действий
Сначала зафиксируйте симптом и время ошибки, затем сделайте резервную копию или тестовую копию, проверьте логи и только после этого меняйте настройки, модификаторы или код. После исправления важно пройти связанные сценарии: каталог, карточку товара, корзину, оплату, письма, мобильную версию и страницы, которые уже попали в Яндекс.
Частые вопросы
Белый экран появился после установки модуля. Что делать?
Сначала нужно посмотреть лог и понять, какой файл падает. Затем безопасно отключить модификатор или модуль и проверить сайт.
Почему после очистки кеша ошибка вернулась?
Значит причина не в кеше, а в коде модуля, шаблона или несовместимости. Кеш только временно меняет проявление ошибки.
Можно ли исправить без простоя?
Часто можно, если есть доступ к файлам, резервная копия и понимание, какой участок отключить или исправить.
Нужна диагностика OpenCart?
Пришлите ссылку на магазин, описание симптома и скриншот или текст ошибки. Я посмотрю, где может быть причина, и предложу безопасный порядок исправления.
Перейти к диагностике