#Что означает ошибка
Белый экран Ошибка выполнения. Попробуйте обновить страницу.
Белый экран на сайте 1С-Битрикс после обновления означает, что PHP завершился фатальной ошибкой, а вывод ошибок отключён. Причины: несовместимость модуля с версией PHP, ошибка в кастомном коде или шаблоне, нехватка памяти, повреждённые файлы обновления.
Чтобы увидеть причину, нужно включить вывод ошибок и прочитать журнал.
Работайте на копии или после резервной копии сайта и базы данных.
Битрикс скрывает ошибки от посетителей. Чтобы увидеть причину, нужен журнал или режим отладки.
#Причины и решения
| Возможная причина | Как узнать | Что делать |
|---|---|---|
| Несовместимая версия PHPВерсия PHP не поддерживается текущей версией Битрикс. | Ошибка после смены PHP. | Верните совместимую версию или обновите Битрикс. |
| Ошибка в модуле, шаблоне или init.phpФатальная ошибка кода. | В журнале указан файл и строка. | Исправьте или отключите виноватое. |
| Нехватка памяти или местаЗакончился лимит или диск. | В журнале Allowed memory size или нет места. | Увеличьте лимит, освободите диск. |
| Права на файлы или БДНет доступа. | Сообщения об отказе доступа или подключения. | Проверьте права и параметры БД. |
#Пошаговое решение
- Включите вывод ошибокЕсли после обновления «1С-Битрикс» страница белая, сперва проверьте
error.logнужного PHP-FPM/веб-сервера в панели хостинга и запишите первую PHP Fatal error. Не включайтеdisplay_errors=Onдля публичного сайта: сообщения могут раскрыть пути и секреты. В закрытом тестовом окружении допустима диагностика ошибок, но на рабочем сервере используйте журналы. - Прочитайте журналЧерез панель хостинга откройте журнал PHP и веб-сервера и сравните строки сразу после времени обновления. Для systemd администратор может выполнить
journalctl -u фактическая_служба_PHP -n 100 --no-pager; версия и имя службы зависят от сервера. Если есть ошибка класса или функции, сверьте требования версии Битрикс и установленные модули PHP. - Очистите кэшЕсли обновление меняло компоненты и данные сохранены, очистите кеш через административную панель Битрикс штатным средством, когда она доступна. При недоступной админке сначала сделайте копию каталога сайта и базы; ручная очистка отдельных кеш-каталогов возможна только с пониманием их роли, но не удаляйте весь
/bitrixили произвольные каталоги. - Проверьте PHP и памятьСверьте рабочую версию PHP именно сайта в панели хостинга и заявленные требования установленного релиза Битрикс. Временно вернитесь на предыдущую поддерживаемую версию только по процедуре панели и при наличии резервной копии. Не выставляйте
memory_limit=256Mмеханически: проверяйте фактический лимит и конкретное сообщениеAllowed memory size exhausted. - Отключите кастомный кодЕсли ошибка совпала по времени с обновлением пользовательского кода в
/bitrix/php_interface/init.php, на стенде временно отключите только подтверждённый проблемный обработчик после копирования файла. Переименование всего init.php в рабочей системе может отключить обработку заказов и другие функции. После исправления откройте главную, админку, каталог и ключевые бизнес-операции; при необходимости выполните откат из проверенной копии.
#Если не помогло
Вывод ошибок включайте только на время диагностики и закрывайте после: подробности ошибок не должны быть доступны посетителям. При серьёзных сбоях включите вывод ошибок (display_errors) и посмотрите журнал: по тексту ошибки найдите модуль и откатите его обновление.
#Как увидеть ошибку
В /bitrix/php_interface/dbconn.php временно включите: error_reporting(E_ALL & ~E_NOTICE); ini_set("display_errors", 1);. В /bitrix/.settings.php в блоке exception_handling установите debug => true. Журнал PHP: sudo tail -n 50 /var/log/php8.2-fpm.log и журнал веб-сервера (/var/log/nginx/error.log). После диагностики обязательно верните настройки.
#Типичные причины
Версия PHP не поддерживается новой версией Битрикса (проверьте требования в «Настройки → Проверка системы»); устаревший код в init.php и шаблонах; недостаток memory_limit (минимум 256M); конфликт с кэшем (очистите: удалите содержимое /bitrix/cache и /bitrix/managed_cache, при необходимости /bitrix/stack_cache); нехватка прав на папки.
#Откат и восстановление
Откатите обновление из резервной копии либо временно переименуйте /local/php_interface/init.php, чтобы исключить кастомный код. Для обновления на новую версию PHP обновляйте платформу заранее. Проверку выполняйте через «Проверка системы» (/bitrix/admin/site_checker.php).