К содержимому

На сайте возникла критическая ошибка WordPress: как найти причину и исправить

Сообщение «На сайте возникла критическая ошибка.» WordPress показывает при фатальной ошибке PHP, чаще всего в плагине или теме после обновления. Сначала смотрят error.log nginx: там будет строка PHP message: PHP Fatal error с текстом ошибки и путём к файлу. По этому файлу определяют плагин или тему и отключают её.

Ошибка WordPress 3 мин чтения

01Фатальная ошибка PHP в плагине или теме

Это самая частая причина. После обновления плагина или темы в коде возникает фатальная ошибка, и WordPress заменяет страницу сообщением о критической ошибке. Текст ошибки и файл видны в /var/log/nginx/error.log в строке вида FastCGI sent in stderr: "PHP message: PHP Fatal error: Uncaught Error: Call to undefined function ... in /var/www/example.com/wp-content/plugins/broken-plugin/.... Если в wp-config.php включены define( 'WP_DEBUG', true ); и define( 'WP_DEBUG_LOG', true );, тот же текст пишется в wp-content/debug.log. По пути в сообщении находят каталог плагина или тему и отключают её.

bash
sudo tail -n 50 /var/log/nginx/error.log | grep 'PHP Fatal error'
sudo -u deploy wp plugin list --path=/var/www/example.com
sudo -u deploy wp plugin deactivate broken-plugin --path=/var/www/example.com

02Плагин нельзя отключить через WP-CLI

Если WP-CLI недоступен или команда падает, каталог проблемного плагина переименовывают внутри wp-content/plugins. WordPress перестаёт видеть плагин и не загружает его код. После этого сайт открывается, а в админке плагин можно удалить или заменить.

bash
cd /var/www/example.com
sudo -u deploy mv wp-content/plugins/broken-plugin wp-content/plugins/broken-plugin.off

03Ошибка установки соединения с базой данных

Иногда вместо критической ошибки WordPress пишет «Ошибка установки соединения с базой данных» (Error establishing a database connection). Это значит, что WordPress не подключился к MySQL с данными из wp-config.php: неверные DB_NAME, DB_USER, DB_PASSWORD или DB_HOST, либо служба MySQL не запущена. Проверяют подключение теми же данными и статус службы.

bash
sudo systemctl status mysql
mysql -u blog -p blog

04WP-CLI запущен от root

При попытке выполнить wp от root выводится Error: YIKES! It looks like you're running this as root. WP-CLI отказывается работать от суперпользователя. Команду повторяют от владельца файлов сайта, например от пользователя deploy, из каталога сайта.

bash
cd /var/www/example.com
sudo -u deploy wp plugin list

05Проверка, что ошибка исчезла

После отключения плагина или темы откройте сайт и /wp-admin/. В error.log не должно появляться новых строк PHP Fatal error с тем же файлом. Если ошибка повторяется, в логе будет другой файл или другая функция, и цикл повторяют с новым плагином.

bash
curl -I https://example.com
sudo tail -n 20 /var/log/nginx/error.log

Что не помогает

  • Сразу переустанавливают WordPress или откатывают всю базу, не прочитав текст фатальной ошибки.

    Сначала находят файл и строку в error.log или wp-content/debug.log. Чаще всего достаточно отключить один плагин.

  • Выставляют chmod 777 на каталоги сайта, чтобы WordPress мог писать файлы.

    Права по умолчанию: каталоги 755, файлы 644. Для установки плагинов PHP-FPM должен работать от владельца файлов сайта, а запись нужна только в wp-content/uploads.

  • Запускают wp от root, потому что от обычного пользователя команда не находится.

    WP-CLI от root не работает. Команду выполняют через sudo -u deploy wp ... из каталога сайта.

Deploykin

Как это делается в Deploykin

В Deploykin логи nginx и PHP-FPM читаются в панели, а здоровье сайта WordPress, от версии ядра до числа плагинов и размера базы, обновляется каждый час. Пароль администратора сбрасывается в один клик, а при смене домена адреса в базе меняются через WP-CLI без битой сериализации.

7 дней бесплатно на тарифе Про, без привязки карты.

Вопросы и ответы

Где WordPress хранит текст критической ошибки?

В error.log nginx в строке PHP message: PHP Fatal error. Если в wp-config.php включены WP_DEBUG и WP_DEBUG_LOG, тот же текст пишется в wp-content/debug.log.

Можно ли исправить ошибку без доступа к админке?

Да. Отключите плагин через WP-CLI командой wp plugin deactivate или переименуйте каталог плагина в wp-content/plugins. Сайт откроется, и плагин можно будет удалить.

Почему после обновления плагина сайт перестал открываться?

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

Что делать, если в логе несколько разных фатальных ошибок?

Начинайте с самой ранней по времени. Отключите плагин из первой ошибки, проверьте сайт, затем переходите к следующей.

Ещё по теме

Установка WordPress на собственный сервер: все материалы темы

Мы используем cookies и сервис веб-аналитики «Яндекс Метрика» (включая Вебвизор) для улучшения работы сайта. Подробности — в политике конфиденциальности.