Ошибка подключения к базе данных обычно выглядит критично: сайт перестает открываться, админка недоступна, а на экране появляется сообщение про database connection, MySQL, PDO или просто белая страница.
Причина не всегда в самой базе. Иногда менялся пароль, порт, host, права пользователя, версия PHP, настройки Docker или файл конфигурации сайта.
С чего начать диагностику
Проверку лучше вести по цепочке: доступы, доступность сервиса, права пользователя, выбранная база, код приложения и лимиты.
- Посмотреть точный текст ошибки или лог приложения.
- Проверить, запущен ли MySQL/MariaDB и доступен ли нужный порт.
- Сверить host, database, user, password в конфиге сайта.
- Проверить права пользователя на нужную базу.
- Проверить, не исчерпаны ли лимиты подключений или место на диске.
Частые причины
- неверный пароль или имя пользователя базы
- изменился host или порт подключения
- MySQL/MariaDB остановился или завис
- пользователь базы не имеет прав
- исчерпан лимит подключений
- после переноса сайта не импортировали базу или указали не ту
Что можно проверить без риска
Если нет доступа к серверу, можно только собрать симптомы и понять, что именно выводит сайт.
- записать точный текст ошибки
- проверить, открывается ли админка хостинга или phpMyAdmin
- вспомнить, менялись ли пароли, тариф, сервер или PHP
- проверить, не закончился ли диск на сервере
- не публиковать конфиг с паролями в открытый чат
Когда лучше не экспериментировать
Не стоит отправлять пароль от базы в небезопасном виде, менять кодировку базы без копии или импортировать дамп поверх рабочей базы. Ошибка подключения часто чинится настройкой, но неправильное действие может повредить данные.
Как я обычно чиню такую проблему
Я проверяю подключение отдельно от сайта, затем сверяю конфиг приложения и смотрю, где именно цепочка ломается: на сети, доступах, правах или запросах.
- Смотрю симптомы: адрес страницы, скриншот ошибки, время появления, что меняли перед сбоем.
- Проверяю серверные логи, конфигурацию сайта, права файлов, базу данных и зависимости.
- Делаю точечную правку: без лишней смены CMS, шаблона или случайной установки плагинов.
- Проверяю результат на основной странице, мобильной версии, формах и важных пользовательских сценариях.
- Кратко объясняю, что сломалось и что сделать, чтобы ошибка не повторялась.
Что подготовить для оценки
- адрес сайта или проблемной страницы
- когда появилась ошибка и что меняли перед этим
- доступ к хостингу, серверу или админке, если он нужен для проверки
- скриншот ошибки или текст из консоли, если он есть
- приоритет: срочно восстановить работу или спокойно разобраться в причине
Сроки
| Неверные доступы или host | 30-60 минут |
|---|---|
| Проблема сервиса MySQL/MariaDB | 1-3 часа |
| Восстановление после переноса или сбоя | после оценки базы |
Вопрос-ответ
Можно ли чинить без доступа к базе?
Полноценно — нет. Нужен хотя бы доступ к конфигу сайта и панели/серверу, чтобы проверить подключение.
Почему сайт работал, а потом перестал?
Частые причины: смена пароля, падение MySQL, нехватка диска, обновление PHP или перенос на другой сервер.
Нужна ли резервная копия?
Да, если предстоят изменения в базе, импорт дампа или восстановление после сбоя.
Итог
Ошибка подключения к базе данных требует аккуратной проверки доступов и сервиса MySQL. Главное — не трогать данные вслепую и сначала понять, почему сайт перестал видеть базу.
Если нужно быстро разобраться с такой ошибкой на сайте, напишите в Telegram: @rabotator_support. Посмотрю симптомы, скажу, что нужно проверить, и предложу аккуратный план исправления.