#Что означает сообщение
Белый экран Битрикс
Белый экран Битрикс после обновления часто скрывает фатальную ошибку PHP, недостающий модуль или несовместимое дополнение. Сначала получите сообщение из серверного журнала.
#Как отличить причины
| Возможная причина | Как узнать | Что делать |
|---|---|---|
| PHP версия | При диагностике «1С-Битрикс: белый экран после обновления» сопоставьте дату сбоя с версией установленного пакета, требуемой платформой и последним обновлением. Важно сопоставить проверку с исходным симптомом, а не с догадкой. | Для случая «1С-Битрикс: белый экран после обновления» используйте только поддерживаемую сборку изготовителя, сохранив возможность возврата. Для проверки результата повторите только прежнее действие. |
| Кастомный код | Сравните момент появления признака «Кастомный код» с тем, когда ранее работала нужная функция. Учитывайте версию Битрикс и условия сбоя. | Исправляйте только подтверждённый фактор «Кастомный код», сохраняя прежние настройки. Изменения вносите по одному, с возможностью возврата. |
| Модуль | Сверьте версию устройства и установленного драйвера с официальными требованиями, а также дату последнего изменения. Учитывайте версию Битрикс и условия сбоя. | Для случая «1С-Битрикс: белый экран после обновления» при совпадении с недавним обновлением установите поддерживаемую версию конкретного драйвера или выполните его штатный откат, затем проверьте действие повторно. Для проверки результата повторите только прежнее действие. |
| Права | Уточните, какой пользователь и к какому объекту обращается; проверьте сообщение об отказе, состояние учётной записи и требуемую роль. Учитывайте версию Битрикс и условия сбоя. | Для случая «1С-Битрикс: белый экран после обновления» восстановите конкретное разрешение или штатную процедуру входа. Изменения вносите по одному, с возможностью возврата. |
#Пошаговое решение
- Зафиксируйте ошибку и проверьте условияЕсли после обновления Битрикс сайт стал белым, откройте журнал PHP-FPM/веб-сервера через панель и сохраните первую Fatal error после времени обновления. Не включайте
display_errorsна публичном сайте, чтобы не раскрыть реквизиты и пути. - Выполните основную проверку и исправлениеЕсли журнал указывает на несовместимый модуль, шаблон или класс PHP, сравните последние обновлённые компоненты с предыдущей рабочей копией. На стенде отключайте только подтверждённо проблемный модуль, не переименовывайте весь
/bitrix/php_interfaceи не удаляйте общие настройки. - Исключите другие подтверждённые причиныПроверьте фактическую версию PHP сайта и установленные модули; CLI может работать на другом интерпретаторе. Если обновление требует иной версии PHP, используйте только поддерживаемый вариант и протестируйте ключевые операции на копии сайта, включая админку и корзину.
- Проверьте, действительно ли проблема решенаПосле устранения Fatal error очистите кеш штатным средством Битрикс и проверьте главную, внутренние страницы, вход и оформление заказа. Если ошибка не исчезла, восстановите рабочую копию сайта и БД по утверждённой процедуре и сохраните журналы для разработчика.
#Что важно перед исправлением
Не включайте показ ошибок посетителям на рабочем сайте и не удаляйте каталог bitrix ядра вручную. Сохраните базу и файлы перед откатом.