Ошибка установки соединения с базой данных WordPress выглядит как белая страница с фразой «Error establishing a database connection»: PHP работает, а до MySQL WordPress достучаться не может. По моей практике она появляется после переезда на другой хостинг, после смены пароля в панели, при переполненном диске и когда у хостера падает сервер MySQL. Ниже порядок, в котором я ищу причину: от самых частых и быстрых в проверке к редким.
Что означает сообщение «Error establishing a database connection»
WordPress при каждом запросе открывает соединение с MySQL по четырём параметрам из wp-config.php: имя базы, пользователь, пароль и адрес сервера. Если соединение не открылось, ядро прекращает работу и выводит эту страницу. Сама страница ничего не говорит о причине, поэтому первая задача - получить настоящий текст ошибки от MySQL.
У текста ошибки несколько типовых вариантов, и каждый указывает на свою причину:
| Текст от MySQL | Что это значит |
|---|---|
| Access denied for user | Неверный логин или пароль, либо у пользователя нет прав на эту базу |
| Unknown database | В DB_NAME указано имя, которого на сервере нет |
| Connection refused или Can’t connect to MySQL server | Неверный DB_HOST либо сервер MySQL остановлен или перегружен |
| Too many connections или max_user_connections | Исчерпан лимит одновременных соединений на хостинге |
Чтобы увидеть такой текст, не выводя его посетителям, я включаю запись в лог. Базовые ошибки базы WordPress печатает только при включённом WP_DEBUG, поэтому в wp-config.php перед строкой «That’s all, stop editing» добавляю:
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
Лог появится в wp-content/debug.log. Все три константы работают только вместе: если WP_DEBUG выключен, остальные ничего не делают. После диагностики я возвращаю WP_DEBUG в false и удаляю лог, потому что в нём могут лежать пути и фрагменты запросов.
Неверные данные подключения: проверка wp-config.php
Это причина номер один. Если сайт работал вчера, а сегодня упал, а вы или хостер что-то трогали в панели, начинать надо отсюда.
Четыре константы
В файле должны стоять значения, совпадающие с данными в панели хостинга:
define( 'DB_NAME', 'имя_базы' );
define( 'DB_USER', 'пользователь' );
define( 'DB_PASSWORD', 'пароль' );
define( 'DB_HOST', 'localhost' );
Что я проверяю по пунктам:
- Имя базы и пользователя. На многих хостингах они идут с префиксом аккаунта, и при переносе сайта его легко потерять или продублировать.
- Пароль. Если вы меняли его в панели хостинга, в
wp-config.phpон сам не обновится. Спецсимволы в пароле требуют внимания: значение стоит в одинарных кавычках PHP, поэтому кавычка или обратный слеш внутри пароля ломают строку. Проще сгенерировать пароль из букв и цифр. - Лишние пробелы и переводы строк, попавшие при копировании из письма хостера или мессенджера.
- Хост. На большинстве shared-хостингов работает
localhost, но часть провайдеров выдаёт отдельный адрес сервера MySQL, и он указан в панели рядом с базой. После переезда это самая частая ошибка: старый хостинг был наlocalhost, а новый требует другой адрес.
Если доступ по SSH есть, значения можно прочитать командами WP-CLI: wp config get DB_HOST и wp config get DB_NAME. А состояние таблиц проверяет wp db check, но она сработает только при рабочем подключении.
Проверка подключения отдельным скриптом
Чтобы исключить влияние плагинов и темы, я проверяю соединение мини-скриптом без WordPress. Кладу файл в корень сайта, открываю в браузере и сразу удаляю:
<?php
mysqli_report( MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT );
try {
$db = new mysqli( 'localhost', 'пользователь', 'пароль', 'имя_базы' );
echo 'Подключение успешно';
} catch ( mysqli_sql_exception $e ) {
echo $e->getMessage();
}
Если скрипт подключился, а WordPress нет, значит в wp-config.php опечатка или конфиг читается из другого места (например, у вас два сайта в соседних папках и правится не тот файл). Если скрипт тоже получил ошибку, вопрос к сервису MySQL или к правам пользователя, и тогда смотрите следующий раздел.
Бесплатный материал
🎁 Полезный скрипт в подарок
Подпишитесь на Telegram - пришлю готовый скрипт по этой теме.
Без спама. Отписка в 1 клик.
Сервер MySQL не отвечает: хостинг, лимиты и диск
Когда данные точно верные, а скрипт всё равно не подключается, причина на стороне сервера. На shared-хостинге это не ваша зона ответственности, но симптомы можно распознать и сразу сформулировать обращение в поддержку.
- Сервер MySQL остановлен или перезапускается. Ошибка тогда плавающая: сайт то открывается, то нет. Проверяю другие свои сайты на том же аккаунте и в той же панели: если упали все, пишу в поддержку хостера.
- Исчерпан лимит соединений. На дешёвых тарифах он небольшой. Всплеск трафика, боты, зависшие запросы тяжёлого плагина или перегруженный cron приводят к текстам вида «Too many connections». Если ошибка появляется под нагрузкой и пропадает сама, дело почти наверняка в этом.
- Переполнен диск или квота аккаунта. Когда место на аккаунте закончилось, MySQL может не записывать данные и отказывать в работе. Смотрю в панели занятое место: забитые логи, бэкапы в корне сайта и архивы со старой версией сайта частые виновники.
- Блокировка по IP или приостановка аккаунта. Хостинг мог приостановить аккаунт за неоплату или за нагрузку, тогда база становится недоступной вместе с сайтом.
В обращении в поддержку я пишу конкретно: время ошибки, текст из debug.log или из тестового скрипта, имя базы и хост. Ответ «проверьте пароль» после этого обычно не приходит, потому что видно, что вы уже его проверили.
Повреждённые таблицы и режим восстановления базы
Иногда подключение работает, но WordPress показывает ошибку из-за повреждённых таблиц, например после аварийной остановки сервера. Характерный признак: сообщение появляется в админке и говорит о проблеме с таблицами, а в логе MySQL есть «Table is marked as crashed».
В WordPress для этого случая есть встроенный режим восстановления. В wp-config.php добавляю строку:
define( 'WP_ALLOW_REPAIR', true );
После этого открываю адрес /wp-admin/maint/repair.php и запускаю «Repair Database». Страница доступна без авторизации, пока константа включена, поэтому как только закончил, строку обязательно убираю. Оставленный открытым repair.php доступен любому посетителю.
Перед восстановлением я делаю дамп базы через phpMyAdmin или панель хостинга. Если сервер повредил таблицу серьёзно, лишняя копия избавит от худшего сценария.
Нестандартные причины, когда всё выглядит правильно
Если основные проверки ничего не дали, смотрю менее очевидные места:
- Файл
wp-content/db.php. Это drop-in, который заменяет стандартный класс работы с базой. Его ставят некоторые плагины кэширования и репликации. Если плагин удалён, а файл остался, или он несовместим с версией PHP, сайт падает с этой же ошибкой. Переименовываю файл по FTP и проверяю. - Смена версии PHP. После перехода на новую версию PHP старые расширения для работы с MySQL могут быть недоступны, а старый плагин может ломать загрузку. Откатываю версию в панели хостинга и смотрю, исчезла ли ошибка.
- Сломанный перенос. При переезде я сверяю не только
wp-config.php, но и то, что база действительно импортировалась в полном объёме. Неполный дамп из-за лимита размера в phpMyAdmin даёт либо пустую базу, либо сайт без части таблиц. - Автоматическое обновление в момент сбоя. Если ошибка появилась сразу после обновления ядра или плагина, откатываю изменение файлов и смотрю
debug.log. Файлы ядра заменяются целиком:wp-admin,wp-includesи файлы в корне. Одной папкойwp-contentтут не обойтись.
Отдельно скажу про ботов и интеграции. Если на сайте стоит приём оплаты через T‑Bank в WooCommerce или расчёт доставки СДЭК, они обращаются к базе из своих обработчиков. Всплеск вебхуков в момент нагрузки быстро выбирает лимит соединений, и ошибка тогда выглядит как «сайт упал без причины». Это стоит иметь в виду, прежде чем винить пароль.
Порядок проверки: 7 шагов
Когда сайт лежит и клиент ждёт, действую по одной и той же последовательности. Она идёт от самого дешёвого и быстрого к тому, что требует вмешательства хостера:
| Шаг | Что делаю | На что смотрю |
|---|---|---|
| 1 | Открываю главную и /wp-admin/ |
Одинаковая ошибка или в админке другое сообщение о таблицах |
| 2 | Включаю WP_DEBUG_LOG |
Точный текст ответа MySQL в debug.log |
| 3 | Сверяю DB_NAME, DB_USER, DB_PASSWORD, DB_HOST с панелью |
Опечатки, лишние пробелы, префикс аккаунта, другой хост |
| 4 | Запускаю тестовый скрипт с mysqli | Подключается ли сервер без WordPress |
| 5 | Смотрю статус MySQL, диск и лимиты в панели | Остановка, квота, лимит соединений, приостановка аккаунта |
| 6 | Запускаю repair.php после дампа |
Сообщения о повреждённых таблицах |
| 7 | Переименовываю wp-content/db.php, откатываю PHP или обновление |
Ошибка исчезает после одного конкретного изменения |
В большинстве случаев причина находится на третьем или пятом шаге. Если дошли до седьмого и ничего не помогло, то либо база действительно потеряна, либо нужен доступ к серверу хостера. Тогда выручает свежий бэкап: я всегда проверяю, что последняя копия базы лежит вне самого хостинга и открывается.
Как не получить ошибку снова
После того как сайт заработал, я делаю несколько вещей, которые снижают шанс повтора:
- Храню копию
wp-config.phpи актуальный дамп базы отдельно от хостинга. Автобэкап хостера лежит на том же аккаунте и пропадает вместе с ним. - Не меняю пароль базы в панели, не записав его сразу в конфиг. Два изменения подряд выглядят мелочью, а между ними сайт лежит.
- Чищу диск от старых архивов и логов и слежу за занятым местом.
- Настраиваю внешний мониторинг, который каждые несколько минут запрашивает главную и присылает уведомление в Telegram. Узнавать о падении от клиента неприятно и дорого.
- Переношу тяжёлые фоновые задачи (рассылки, синхронизации, парсинг) на расписание, чтобы они не выбирали лимит соединений в часы пик.
Если сайт приносит заявки или продажи, держать такую проверку вручную неудобно. На этот случай я предлагаю техподдержку сайта от 15 000 ₽/мес, где мониторинг, резервные копии и разбор сбоев закрываются в одном месте.
WordPress и панели хостингов регулярно обновляются, поэтому перед правками конфигурации я сверяюсь с актуальной документацией WordPress и справкой самого хостера.
Частые вопросы
Можно ли исправить ошибку, не имея доступа к хостингу?
Если вы не можете открыть ни панель, ни FTP, исправить её нельзя: все причины лежат либо в wp-config.php, либо на стороне MySQL. В таком случае остаётся обратиться к тому, у кого есть доступ, или к хостеру, и передать ему текст ошибки и время сбоя.
Почему ошибка пропадает и снова появляется?
Плавающая ошибка почти всегда говорит о лимите соединений или о перегрузке сервера MySQL. Постоянные данные в wp-config.php не могут то работать, то нет. Проверьте, совпадают ли падения с пиками трафика и с запуском тяжёлых задач, и уточните лимиты вашего тарифа в справке хостинга.
Сотрутся ли данные, если запустить repair.php?
Режим восстановления пытается починить повреждённые таблицы и не должен удалять нормальные данные, но гарантий при серьёзной поломке никто не даёт. Поэтому перед запуском я всегда делаю дамп базы, а после работы убираю WP_ALLOW_REPAIR из конфига.
Ошибка появилась после переезда. С чего начать?
С адреса сервера в DB_HOST и с префикса имени базы и пользователя. На новом хостинге они чаще всего отличаются от старого. Затем проверьте, что дамп импортировался целиком: загрузка через phpMyAdmin нередко обрывается из-за ограничения размера файла.