Журнал ошибок MySQL и MariaDB: где лежит и как его читать
Если база не запускается или упала, причину она записывает в журнал ошибок. MySQL в Ubuntu пишет его в файл /var/log/mysql/error.log, MariaDB — в журнал systemd. Ниже — команды, которые показывают последние строки, и что значат главные записи.
Содержание 10
Что сделать прямо сейчас
- Подключитесь к серверу по SSH (как подключиться).
- Посмотрите последние 50 строк журнала. Для MySQL:
sudo tail -n 50 /var/log/mysql/error.log. Для MariaDB:sudo journalctl -u mariadb -n 50 --no-pager. sudo может спросить пароль вашего пользователя на сервере: символы при вводе не видны, наберите пароль и нажмите Enter. - Найдите строки со словом ERROR или Error — в них причина. Строки с Warning — предупреждения, с ними база работает.
- Исправьте причину по таблице ниже и запустите базу:
sudo systemctl restart mysqlилиsudo systemctl restart mariadb. - Проверьте, что база работает:
sudo systemctl status mysqlилиsudo systemctl status mariadb. В ответе должно бытьactive (running).
Где лежит журнал
| База | Куда пишет ошибки | Как посмотреть |
|---|---|---|
| MySQL 8.0 | в файл /var/log/mysql/error.log — так задано строкой log_error в файле /etc/mysql/mysql.conf.d/mysqld.cnf | sudo tail -n 50 /var/log/mysql/error.log |
| MariaDB 10.11 | в журнал systemd: строка log_error в файле /etc/mysql/mariadb.conf.d/50-server.cnf закомментирована | sudo journalctl -u mariadb -n 50 --no-pager |
Путь к журналу у MySQL покажет команда в консоли базы: SELECT @@log_error; Войти в консоль — sudo mysql. Если вы меняли строку log_error, журнал лежит там, куда она указывает.
Если в ответе на tail пусто, а база не запускается, загляните ещё и в журнал службы: sudo journalctl -u mysql -n 50 --no-pager. Туда systemd пишет, что служба не поднялась.
Как найти только ошибки
Журнал бывает длинным: при каждом запуске база пишет туда десятки служебных строк. Оставить только строки с ошибками помогает grep:
- MySQL:
sudo grep -i error /var/log/mysql/error.log | tail -n 20 - MariaDB:
sudo journalctl -u mariadb --no-pager | grep -i error | tail -n 20
В каждой строке журнала есть дата и время записи и метка важности в квадратных скобках:
| Метка | Что значит |
|---|---|
| ERROR или Error | ошибка: из-за неё база могла не запуститься или не выполнить действие |
| Warning | предупреждение: база работает, но что-то настроено не так |
| Note | сведения о работе базы |
| System | служебная запись MySQL о запуске и остановке |
В MySQL после метки стоит ещё код записи — MY- и шесть цифр — и часть базы, которая её написала, например [Server].
Смотрите на время записи: нужны строки за ту минуту, когда база перестала работать.
Как следить за журналом в реальном времени
Удобно открыть два окна терминала: в одном журнал, в другом — перезапуск базы.
- MySQL:
sudo tail -f /var/log/mysql/error.log - MariaDB:
sudo journalctl -u mariadb -f
Новые строки появятся на экране сразу, как база их запишет. Выйти — Ctrl+C.
Почему база не запускается: что искать в журнале
| Строка в журнале | Причина | Что делать |
|---|---|---|
unknown variable 'имя=значение' | опечатка в имени настройки в файле настроек | исправьте или удалите строку и перезапустите базу; имена настроек — в статье настройки MySQL и MariaDB |
unknown option '--имя' | в файле строка без знака «=», и такой настройки нет | исправьте или удалите строку |
Found option without preceding group in config file (MySQL) | строка настройки стоит выше заголовка раздела, например выше [mysqld] | перенесите строку под [mysqld] |
Can't start server: Bind on TCP/IP port и Do you already have another mysqld server running on port: 3306 ? (MySQL) | порт 3306 занят: на сервере уже работает вторая база | посмотрите, кто занял порт: sudo ss -tlnp — найдите в списке строку с :3306; подробнее — в статье порт 3306 |
Out of memory (MySQL) | базе не хватило памяти | уменьшите innodb_buffer_pool_size и проверьте свободную память: free -h |
Aborting (MySQL) | итог: база прервала запуск | причина — в строках ERROR чуть выше |
Тексты сверены с исходным кодом MySQL 8.0.46. В MariaDB тексты про unknown variable и unknown option те же, только перед ними стоит имя программы базы.
Как включить запись ошибок MariaDB в файл
Журнал systemd удобен, но файл проще отправить специалисту или в поддержку. В файле 50-server.cnf уже есть нужная строка, её нужно только включить.
- Откройте файл:
sudo nano /etc/mysql/mariadb.conf.d/50-server.cnf - Найдите строку
#log_error = /var/log/mysql/error.logи сотрите знак#в её начале. - Сохраните файл: Ctrl+O, затем Enter. Выйдите: Ctrl+X.
- Проверьте, что папка для журнала есть:
ls -ld /var/log/mysql. Если папки нет, создайте её и отдайте базе — так советуют подсказки в самом файле 50-server.cnf:sudo mkdir -m 2750 /var/log/mysql, затемsudo chown mysql /var/log/mysql. - Перезапустите базу:
sudo systemctl restart mariadb. - Читайте журнал из файла:
sudo tail -n 50 /var/log/mysql/error.log.
Если после правки база не запустилась, верните знак # в начало строки, снова перезапустите базу и посмотрите причину в sudo journalctl -u mariadb -n 50 --no-pager.
Сколько подробностей писать в журнал
В MySQL подробность задаёт настройка log_error_verbosity:
| Значение | Что попадает в журнал |
|---|---|
| 1 | только ошибки |
| 2 | ошибки и предупреждения — так после установки |
| 3 | ошибки, предупреждения и сведения о работе |
Записи о запуске и остановке базы MySQL пишет при любом значении. Поменять значение можно без перезапуска, в консоли базы: SET PERSIST log_error_verbosity = 3; Слово PERSIST сохраняет значение и после перезапуска. Как вернуть всё назад и чем SET PERSIST отличается от SET GLOBAL — в статье настройки MySQL и MariaDB.
В MariaDB подробность задаёт log_warnings, после установки она равна 2.
Другие журналы базы
- Журнал медленных запросов — записывает запросы, которые выполнялись дольше заданного времени: как его включить.
- Журнал всех запросов (general_log) — записывает каждый запрос. Подсказки в файлах настроек Ubuntu предупреждают, что он сильно нагружает базу: включайте его только на время проверки и сразу выключайте.
Всё сверено с MySQL 8.0 и MariaDB 10.11 — эти версии ставятся в Ubuntu 24.04.
Источники
- Документация MySQL 8.0: The Error Log — на английском: что пишет журнал ошибок.
- Документация MySQL 8.0: Default Error Log Destination Configuration — на английском: опция log-error и значение stderr.
- Документация MySQL 8.0: Server System Variables — на английском: log_error_verbosity, значения 1–3 и записи о запуске.
- Документация MariaDB: Error Log — на английском: запись в файл, в stderr и журнал systemd, метки Note, Warning и Error.
- Документация MariaDB: Server System Variables — на английском: log_error и log_warnings.
- Файл mysqld.cnf из пакета mysql-8.0 в Ubuntu 24.04 — строка log_error = /var/log/mysql/error.log.
- Файл 50-server.cnf из пакета mariadb в Ubuntu 24.04 — закомментированная строка log_error и подсказка про папку /var/log/mysql.
- Исходный код MySQL 8.0.46: messages_to_error_log.txt — тексты записей журнала: Bind on TCP/IP port, Out of memory, Aborting.
- Исходный код MySQL 8.0.46: log_sink_trad.cc — как строится строка журнала: время, метка ERROR, Warning, Note или System, код MY-.
- Исходный код MySQL 8.0.46: mysys/errors.cc — тексты unknown variable и unknown option.
- Исходный код MariaDB 10.11.14: mysys/my_getopt.c — тексты unknown variable и unknown option в MariaDB.
Сверено 23 октября 2026 года.
Что почитать дальше
- Настройки MySQL и MariaDBгде лежат файлы настроек и как менять значения.
- Журнал медленных запросовкакие запросы тормозят сайт.
- Ошибки MySQL и MariaDBчто значат номера ошибок.
- Порт 3306кто слушает порт базы.