#Признаки проблемы и применимость
После обновления ядра или модуля 1С-Битрикс на конкретной странице появляется PHP Fatal error, связанный с компонентом. Нельзя автоматически считать повреждённым ядро: ошибку может создавать переопределённый шаблон компонента, устаревшее стороннее решение либо версия PHP.
#Причины и отличительные признаки
| Возможная причина | Как узнать | Что делать |
|---|---|---|
| Шаблон компонента не совместим с обновлениемШаблон компонента не совместим с обновлением. Путь в ошибке указывает /local/templates или /bitrix/templates | Путь в ошибке указывает /local/templates или /bitrix/templates | Проверить изменения шаблона на копии |
| Устарел сторонний модульУстарел сторонний модуль. Ошибка появляется только в разделе, где подключён модуль | Ошибка появляется только в разделе, где подключён модуль | Обновить решение совместимо с ядром |
| PHP не соответствует требованиямPHP не соответствует требованиям. После обновления модуля возник вызов несовместимой функции | После обновления модуля возник вызов несовместимой функции | Сопоставить поддержку PHP и версии |
#Пошаговая диагностика и исправление
- Сохраните исходное состояниеЗапишите точный адрес сбойной страницы, время обновления и список затронутых компонентов. Сделайте копию файлов и базы; если админка недоступна, проверьте сохранённый архив у провайдера. Не проводите очередное обновление, пока причина не ясна.
- Определите область неисправностиОткройте главную и сбойный раздел в частном окне. Если падает только карточка товара, сравните подключённые компоненты и шаблон раздела; если весь сайт — сначала исследуйте глобальный PHP или загрузку ядра. В ответах 500 нет сведений о точном источнике ошибки.
- Найдите запись PHP, не показывая её посетителямВ панели хостинга откройте журнал ошибок PHP для нужного домена и сопоставьте время. Посмотрите тип исключения, класс, файл и строку. Не включайте display_errors на публичном сайте и не пересылайте журнал целиком: там могут быть персональные данные.
- Проверьте назначенную веб-сайту версию PHPВ панели управления хостингом найдите версию PHP выбранного домена/пула. Сравните её с официальными требованиями установленного ядра и дополнений Битрикс. Команда php -v по SSH показывает только командную строку и не подтверждает настройки веб-сайта. Обновление PHP планируйте отдельно с копией.
- Сопоставьте ошибочный путь с видом кодаПуть /bitrix/components может указывать на модуль или ядро, /local/components — на собственное решение, а /local/templates — на шаблон. Нажмите на файл в файловом менеджере и только прочитайте строку. Не редактируйте ядро /bitrix на действующем сервере.
- Выполните испытание на копииРазверните согласованную резервную копию на тестовом домене, повторите страницу. Обновите затронутое стороннее решение или временно восстановите прежний шаблон компонента в тестовой копии; убедитесь, что проблема уходит при единственном изменении. Если нет — восстановите тестовое исходное состояние и проверьте другой фактор.
- Примените минимальную проверенную правкуВ согласованное окно разверните совместимую версию компонента и очистите кеш конкретной страницы штатным способом. Проверьте 2–3 URL, личный кабинет и оформление заказа, если компонент связан с магазином. При новой ошибке восстановите заранее сохранённые файлы и базу одной согласованной версии.
#Проверка результата
Конкретная страница и соседние разделы возвращают нормальные ответы, в журнале нет повторного исключения, основные операции с компонентом выполняются.
#Что делать, если не помогло
Если ошибка сохраняется после отката темы, проверьте обновления сторонних модулей, настройки PHP, права и неполное обновление ядра. Передавайте разработчику только очищенный фрагмент ошибки и номера версий.