#Что означает ошибка
Белый экран
Включите вывод ошибок в .settings.php (exception_handling → debug) и смотрите лог PHP. Часто причина — несовместимая версия PHP или ошибка в шаблоне.
#Причины и признаки
| Возможная причина | Как узнать | Что делать |
|---|---|---|
| Ошибка в шаблоне | Прочитайте относящуюся к этому компоненту запись в журнале до изменения конфигурации. | Исправьте. |
| Версия PHP | Уточните установленную версию и поддерживаемые требования; обновления берите только у разработчика. | Подберите. |
| Нет памяти | Проверьте фактическое потребление памяти и наличие места для временных файлов в момент сбоя. | Увеличьте. |
| Битый кэш | Повторите действие после штатного закрытия приложения; очистка кэша нужна лишь после сохранения пользовательских данных. | Очистите. Перед этим сохраните настройки и локальные данные, которые могут быть потеряны. |
#Пошаговое решение
- Включите отладкуЕсли Битрикс показывает белую страницу, сначала откройте журнал PHP через панель хостинга и найдите свежую Fatal error. Для диагностики включайте сбор ошибок в закрытый лог выбранного пула PHP, а не отображение всех ошибок посетителю: в сообщениях могут быть секретные пути и параметры подключения.
- Читайте логПосле воспроизведения ошибки посмотрите время, имя файла и строку в журнале PHP-FPM/веб-сервера. Если ошибка относится к ядру, модулю или шаблону, сопоставьте её с последними обновлениями и системными требованиями. Сохраните фрагмент лога без паролей для разработчика.
- Проверьте шаблонНа стенде отключите только пользовательский шаблон либо обработчик, прямо указанный в журнале, сохранив копию файла. Не удаляйте все файлы
/bitrix/cacheилиinit.phpпри отсутствии доказательств; это способно отключить полезные обработчики и повысить нагрузку. - Проверьте альтернативу: битый кэшПосле исправления повторите проблемную страницу в приватном окне и проверьте, что ошибок в PHP-журнале больше нет. Верните настройки отображения ошибок к безопасным значениям, удалите временные диагностические файлы и проверьте админку и основные операции сайта.
#Проверка результата
Для «1С-Битрикс: белый экран — как включить отладку» выполните штатную проверку конфигурации, затем один контрольный запрос к сервису. Сверьте его результат с журналом и убедитесь, что пользователи не получили новых ответов 4xx или 5xx после изменения.