Распространенные ошибки Битрикс

Ошибки на сайте случаются у всех. Самое неприятное — увидеть белую страницу и начать менять всё подряд. Обычно так становится только хуже.

Лучше идти по порядку: сохранить текст ошибки, понять, когда она появляется, и проверить простые вещи — место на диске, доступность базы и недавние изменения.

Первое правило: не показывайте ошибку посетителям

Техническое сообщение может подсказать злоумышленнику путь к файлу, версию PHP или устройство сайта. Поэтому на боевом сайте не включайте публичный подробный вывод ошибок. Он нужен только в закрытой тестовой среде или временно для администратора.

Если ошибка появилась после обновления, сначала зафиксируйте время и сделайте резервную копию. Не ставьте права 777 на папки в надежде, что «так заработает»: это открывает доступ слишком широко и обычно не решает настоящую причину.

«Не удалось подключиться к базе данных»

Текст ошибки может отличаться в зависимости от версии платформы и настройки сервера.

Такая ошибка не всегда означает неверный пароль. Возможные причины простые:

сервер базы данных временно недоступен;
на сервере закончилось место;
после переноса сайта поменялись параметры подключения;
пользователь базы потерял права.

Проверьте, открываются ли другие сайты на том же хостинге, есть ли свободное место и были ли работы у хостера. Параметры подключения — секретные данные. Не вставляйте их в тикет, чат или скриншот. Если правите конфигурацию, сначала сделайте резервную копию файла и работайте через безопасный доступ администратора.

Белая страница после изменения PHP-кода

Частая причина — синтаксическая ошибка в недавно изменённом файле или несовместимость старого кода с новой версией PHP. Откатите только последнюю понятную правку из резервной копии или Git, затем откройте журнал ошибок сервера.

Не включайте отладку для всех посетителей. На тестовом стенде можно временно увидеть подробность ошибки, исправить её и сразу вернуть безопасный режим. На бою оставляйте подробности в закрытом журнале, а пользователю показывайте обычную страницу ошибки.

Страница стала медленной

Сначала уточните: медленно у всех или только у вас? Проверьте страницу без авторизации, с другого устройства и в другое время. Затем посмотрите:

свободное место и нагрузку на сервере;
не запускался ли импорт из 1С, резервное копирование или большой агент;
не появился ли тяжёлый запрос к инфоблоку или базе;
не менялись ли шаблон, модуль или версия PHP.

Если нашли медленный запрос, не угадывайте оптимизацию. Сначала измерьте время до и после правки на тестовой копии.

404: страница не найдена

После переноса или правки URL убедитесь, что работает обычная 404-страница, а старые адреса при необходимости перенаправляют посетителя кодом 301. Не удаляйте старую страницу, пока не понимаете, откуда на неё идут ссылки и есть ли переходы из поиска.

<?php
if (defined('ERROR_404') && ERROR_404 === 'Y') {
    // Здесь подключают понятный шаблон страницы «Не найдено».
}
?>

Порядок действий, который помогает

Запишите точный текст ошибки и адрес страницы.
Проверьте, повторяется ли ошибка у обычного посетителя.
Посмотрите последние безопасно доступные журналы и изменения на сервере.
Восстановите только понятный файл или настройку из резервной копии.
Проверьте сайт после исправления и убедитесь, что секреты не попали в публичный вывод.

Если данных мало, лучше остановиться и позвать администратора хостинга или разработчика. Это дешевле, чем случайно испортить базу или открыть доступ к файлам сайта.

Статья обновлена 3 октября 2026 года. Советы относятся к диагностике сайта, а не заменяют резервное копирование и проверку конкретного сервера.