#Что означает ошибка
Ошибка соединения с БД
Надпись «Error establishing a database connection» (на русскоязычных сайтах — «Ошибка при установке соединения с базой данных») означает, что WordPress не смог обратиться к MySQL или MariaDB. Сам движок на PHP при этом работает, но без базы не может показать ни одной записи, поэтому вместо сайта выводится только эта строка.
Ошибка возникает как после изменений на сервере (смена пароля пользователя БД, перенос хостинга, переполнение диска), так и сама по себе, если служба MySQL упала из-за нехватки памяти. Ниже — причины в порядке убывания вероятности.
#Причины и решения
| Возможная причина | Как узнать | Что делать |
|---|---|---|
| Неверные данные подключения в wp-config.phpПароль, имя базы, пользователь или хост (DB_HOST) не соответствуют реальным. Типично после переноса сайта и смены пароля в панели хостинга. | Ошибка появилась сразу после переноса или смены пароля; админка тоже недоступна. | Сверьте DB_NAME, DB_USER, DB_PASSWORD, DB_HOST с данными из панели и исправьте. |
| Служба MySQL остановлена или перегруженаНа слабых VPS ядро убивает процесс mysqld при нехватке памяти (OOM). Сайт работает, затем внезапно «падает» и иногда оживает сам. | Ошибка появляется периодически, в журнале — записи об OOM или о перезапуске MySQL. | Перезапустите службу, увеличьте RAM или настройте swap и ограничьте буферы MySQL. |
| Повреждены таблицы базыПосле аварийного отключения или переполнения диска таблицы MyISAM/InnoDB могут оказаться повреждены; в админке видно сообщение о необходимости восстановления. | Часть страниц открывается, часть нет; в логах — Table is marked as crashed. | Включите WP_ALLOW_REPAIR в wp-config.php и выполните восстановление на странице /wp-admin/maint/repair.php. |
| Закончилось место на диске или превышены лимиты хостингаКогда диск заполнен, MySQL не может писать во временные файлы и отказывает в подключении. На виртуальном хостинге может быть исчерпан лимит соединений. | df показывает 100%, на хостинге пришло предупреждение о превышении. | Освободите место (логи, бэкапы, кэш) или повысьте тариф. |
#Как исправить
- Проверьте wp-config.phpЧерез защищённый файловый менеджер откройте
wp-config.phpи сверьтеDB_NAME,DB_USER,DB_HOSTс настройками хостинга. Пароль не выкладывайте в журнал и не копируйте в незашифрованный файл; при смене пароля обновите конфигурацию синхронно с учётной записью MySQL. - Проверьте подключение вне WordPressПо SSH с теми же реквизитами выполните
mysql -h фактический_хост -u фактический_пользователь -p имя_базы -e "SELECT 1"; получите либо1, либо точный код отказа. При 1045 разбирайте права/пароль, при 2002/2003 — адрес и службу. Не выполняйте тест под root вместо пользователя WordPress. - Проверьте службу и памятьЕсли MySQL локальный, проверьте
systemctl status mysqlи журнал на перезапуски и OOM, а также доступность сокета/порта. В панели виртуального хостинга состояние сервиса выясняйте у провайдера, а не пытайтесь перезапустить чужой общий сервер. - Восстановите таблицыЕсли сообщение явно указывает на повреждённую таблицу, сначала сохраните дамп и определите тип движка. Для InnoDB автоматический
REPAIR TABLEне является универсальным решением; восстановление проводите по проверенной резервной копии. Не включайтеWP_ALLOW_REPAIRна публичном сайте без понимания ограничения доступа. - Проверьте местоПроверьте
df -hиdf -iдля раздела с базой и квоту панели хостинга; при переполнении остановите рост журналов и резервных копий безопасным способом. После освобождения места откройте главную,/wp-admin/и несколько записей, проверяя новые ошибки MySQL. - Команды для отдельных ситуацийВыберите только подходящий вариант. Это не одна последовательность: часть команд диагностирует проблему, а часть меняет настройки или данные.
#Что важно учесть
Перед любыми операциями с таблицами сделайте дамп базы (mysqldump) и копию файлов сайта. Если ошибка появилась только в админке, а на сайте всё работает, проверьте также права пользователя БД и поле DB_HOST: для некоторых хостингов требуется отдельный адрес сервера баз данных.
Не оставляйте строку WP_ALLOW_REPAIR включённой: страница восстановления доступна без авторизации, и ею могут воспользоваться посторонние.