Joomla: Error displaying the error page / Database connection error

#Что означает ошибка

Joomla подключается к базе данных по параметрам из configuration.php: $host, $user, $password, $db, $dbprefix. Если подключение не удаётся, сайт показывает «Database connection error» (или «Error displaying the error page: Application Instantiation Error»). Проблема практически всегда либо в этих параметрах, либо в самом сервере БД. Поэтому сначала проверьте вход вручную, затем службу, затем права.

#Причины и решения

#Пошаговое решение

1. Откройте configuration.phpОткройте журнал ошибок сайта в панели хостинга или через SSH и найдите строку около времени появления Database connection error: Access denied, Unknown database, Connection refused или Too many connections. Запишите конкретное сообщение, не копируя пароль базы. Другая ошибка на той же странице может быть вторичной, потому что Joomla сама не может показать страницу ошибки при сбое базы.
2. Проверьте вход вручнуюВ файловом менеджере панели откройте configuration.php Joomla и найдите поля host, user, db, dbprefix и параметр пароля password. Сравните их с реквизитами активной базы в панели «Базы данных». Никогда не размещайте весь configuration.php в общедоступном каталоге и не публикуйте значение пароля в запросе поддержки. Перед исправлением сохраните копию конфигурации.
3. Проверьте службу MySQLВ панели хостинга откройте раздел «Базы данных» и проверьте, что нужная база существует, а пользователь назначен именно ей. Если сервер базы отдельный, сравните hostname и разрешённые адреса подключения. Для опытного администратора с SSH возможна проверка mysql -h РЕАЛЬНЫЙ_ХОСТ -u РЕАЛЬНЫЙ_ПОЛЬЗОВАТЕЛЬ -p РЕАЛЬНАЯ_БАЗА -e "SELECT 1;"; замените примеры и вводите пароль только в интерактивном приглашении.
4. Проверьте праваЕсли MySQL/MariaDB остановлена и вы управляете сервером, выполните sudo systemctl status mysql --no-pager или mariadb — название зависит от дистрибутива. При остановке проверьте sudo journalctl -u mysql -n 80 --no-pager, свободное место df -h и недавние изменения. Перезапуск в продуктивной среде требует окна обслуживания; на обычном хостинге обратитесь к провайдеру.
5. Проверьте префикс таблицПри Access denied проверьте точную пару пользователь/хост, а не выдавайте права всем. В phpMyAdmin или панели проверьте существующие разрешения пользователя на конкретную базу. Команда GRANT ALL PRIVILEGES из универсального примера может чрезмерно расширить полномочия; сначала согласуйте необходимый набор прав с владельцем приложения и сохраните текущие настройки. Не меняйте права без подтверждённого диагноза.
6. Проверьте путь и права файлаЕсли база есть, но таблиц не видно, сравните префикс dbprefix в конфигурации Joomla с названиями таблиц в phpMyAdmin. При несовпадении после переноса проверьте дамп базы и выполнявшиеся изменения. Не переименовывайте таблицы и не меняйте префикс на рабочем сайте без полной резервной копии файлов и базы: ошибка может затронуть пользователей и расширения.
7. Включите отладкуПосле исправления подключений откройте сайт и /administrator, проверьте страницу с материалами и запись тестового черновика (при наличии полномочий). В журнале не должно быть нового отказа в соединении. Если ошибка повторяется под нагрузкой, проверьте ограничения подключений и доступность БД с администратором сервера, а не повышайте лимиты вслепую.
8. Проверьте таблицыЕсли восстановить подключение не удалось, подготовьте для поддержки точное время, имя сервера БД без паролей, текст исключения и результат проверки наличия базы. Сообщите, выполнялся ли перенос хостинга или изменение настроек PHP. До выяснения причины не запускайте SQL-команды очистки, восстановления таблиц или переустановку Joomla: они могут уничтожить данные.
9. Команды для отдельных ситуацийВыберите только подходящий вариант. Это не одна последовательность: часть команд диагностирует проблему, а часть меняет настройки или данные.
   Выберите подходящий вариант — это не команды для последовательного выполнения

   Вариант 1Проверка доступа и выдача прав (замените имена; выполняйте под администратором MySQL).

   Linux · Терминал (Bash)С осторожностьюКопировать всёВыделить

   Проверка доступа и выдача прав (замените имена; выполняйте под администратором MySQL).

   mysql -h localhost -u joomla_user -p joomla_db -e "SELECT 1;"

   # Замените пользователь, базу и адрес на действительные из configuration.php.

   # Права не повышайте без точного диагноза.

   Команда может изменить состояние системы или её настройки. Проверьте параметры и последствия перед запуском.

   Вариант 2Параметры подключения в configuration.php.

   PHPКопировать всёВыделить

   Параметры подключения в configuration.php.

   public $host = 'localhost';
   public $user = 'joomla_user';
   public $password = '********';
   public $db = 'joomla_db';
   public $dbprefix = 'jos_';

После диагностики верните настройки отладки: показ ошибок на публичном сайте выдаёт структуру сервера. Если при переносе сайта были изменены имя пользователя или префикс, правка параметров решит проблему без восстановления данных. Для версий Joomla 4 и 5 требуется PHP 8.1 и новее; несовместимая версия PHP тоже приводит к ошибке «Error displaying the error page», поэтому проверьте версию в панели хостинга. Документация — Joomla Docs.