На сайте возникла критическая ошибка WordPress: как найти причину и исправить
Сообщение «На сайте возникла критическая ошибка.» WordPress показывает при фатальной ошибке PHP, чаще всего в плагине или теме после обновления. Сначала смотрят error.log nginx: там будет строка PHP message: PHP Fatal error с текстом ошибки и путём к файлу. По этому файлу определяют плагин или тему и отключают её.
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. По пути в сообщении находят каталог плагина или тему и отключают её.
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 перестаёт видеть плагин и не загружает его код. После этого сайт открывается, а в админке плагин можно удалить или заменить.
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 не запущена. Проверяют подключение теми же данными и статус службы.
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, из каталога сайта.
cd /var/www/example.com
sudo -u deploy wp plugin list
05Проверка, что ошибка исчезла
После отключения плагина или темы откройте сайт и /wp-admin/. В error.log не должно появляться новых строк PHP Fatal error с тем же файлом. Если ошибка повторяется, в логе будет другой файл или другая функция, и цикл повторяют с новым плагином.
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 Как зайти в админку WordPress на своём сервере Как зайти в админку WordPress на Ubuntu 24.04: установка WP-CLI, настройка nginx и PHP-FPM, вход через /wp-admin/, смена пароля и проверка работы.
- Руководство · WordPress Настройка wp-config.php через WP-CLI: пошаговое руководство Создайте wp-config.php через WP-CLI: команды, параметры базы, ключи и соли, проверка подключения к MySQL и работа сайта на Ubuntu 24.04.
- Руководство · WordPress Установка и настройка WordPress на своём сервере Ubuntu 24.04 Пошаговая установка WordPress на Ubuntu 24.04: nginx 1.24, PHP 8.3, MySQL 8.0, WP-CLI, wp-config.php, права, проверка сайта и типичные ошибки с исправлениями.
- Ошибка · Nginx Ошибка 502 Bad Gateway в nginx: причины и исправление Разбираем ошибку 502 Bad Gateway в nginx: почему PHP-FPM не отвечает, как читать error.log, проверять сокет и права, чинить таймауты и буферы.
- Ошибка · MySQL Ошибка MySQL: как найти причину и исправить Разбор частых ошибок MySQL: 1045, 1698, 2002, 2003, 1114, 1040, 1064. Как определить причину по номеру и коду SQLSTATE и исправить командами.
- Ошибка · SSL Ошибка unable to get local issuer certificate: причины и исправление Ошибка unable to get local issuer certificate: почему клиент не находит промежуточный сертификат в цепочке, как проверить fullchain.pem через openssl и исправить…
Установка WordPress на собственный сервер: все материалы темы