max_connections: ошибка Too many connections в MySQL и MariaDB
max_connections — сколько подключений база принимает одновременно. После установки MySQL и MariaDB это 151. Когда все места заняты, новое подключение получает ошибку 1040 Too many connections, а сайт пишет, что не может подключиться к базе.
Содержание 11
Что сделать прямо сейчас
- Подключитесь к серверу по SSH (как подключиться) и откройте консоль базы:
sudo mysqlдля MySQL илиsudo mariadbдля MariaDB. Сверх предела база держит одно запасное место для администратора, поэтому root может войти и тогда, когда сайт уже получает ошибку. - Посмотрите предел:
SHOW VARIABLES LIKE 'max_connections'; - Посмотрите, сколько подключений было одновременно на пике:
SHOW STATUS LIKE 'Max_used_connections';Если это число дошло до предела, база упиралась в него. - Посмотрите, кто занял подключения:
SHOW PROCESSLIST;— что значат столбцы, написано ниже. - Поднимите предел без перезапуска, например до 300:
SET GLOBAL max_connections = 300;Затем запишите то же число в файл настроек, иначе после перезапуска базы вернётся старое.
Как выглядит ошибка
В консоли, в журнале сайта и в письмах от программ ошибка выглядит так: число 1040 и текст Too many connections. Если в базе включены русские сообщения, текст будет «Слишком много соединений». WordPress в этот момент показывает страницу Error establishing a database connection.
Ошибка значит, что база работает, но все места для подключений заняты. Когда часть подключений закроется, сайт может открыться снова, а при следующем наплыве посетителей ошибка вернётся.
Что задаёт эта настройка
Подключение — это открытый сеанс программы с базой: страница WordPress, которую сейчас собирает PHP, консоль mysql, программа резервного копирования. Место занято, пока программа не закроет подключение.
| Что | Значение |
|---|---|
| после установки | 151 — и в MySQL, и в MariaDB |
| какие числа можно задать | MySQL — от 1 до 100000, MariaDB — от 10 до 100000 |
| где задать | раздел [mysqld] в /etc/mysql/mysql.conf.d/mysqld.cnf (MySQL) или /etc/mysql/mariadb.conf.d/50-server.cnf (MariaDB) |
| меняется без перезапуска | да, командой SET GLOBAL |
| запасное место | одно сверх предела — для пользователя с правом CONNECTION_ADMIN или SUPER, например root |
Сколько подключений сейчас и на пике
Все три команды выполняются в консоли базы:
| Команда | Что показывает |
|---|---|
SHOW STATUS LIKE 'Threads_connected'; | сколько подключений открыто сейчас |
SHOW STATUS LIKE 'Max_used_connections'; | больше всего подключений одновременно с запуска базы |
SHOW STATUS LIKE 'Connection_errors_max_connections'; | сколько подключений база не пустила из-за предела |
Ответ выглядит так:
+----------------------+-------+
| Variable_name | Value |
+----------------------+-------+
| Max_used_connections | 151 |
+----------------------+-------+В примере пик — 151 при пределе 151: база заполнялась целиком. Если же пик намного ниже предела, а сайт пишет об ошибке подключения, причина в другом — начните с журнала ошибок базы.
Счётчики Max_used_connections и Connection_errors_max_connections считают с последнего запуска базы. После перезапуска они начинаются с нуля.
Кто занял подключения
Команда SHOW PROCESSLIST; выводит по строке на каждое подключение. Пользователь с правом PROCESS, например root, видит все подключения, остальные — только свои.
| Столбец | Что в нём |
|---|---|
| Id | номер подключения — нужен, чтобы закрыть его командой KILL |
| User | пользователь базы, от имени которого пришли |
| Host | откуда пришли: localhost — с этого же сервера, адрес с номером порта — с другого компьютера |
| db | какая база выбрана |
| Command | что делает подключение: Sleep — открыто и ждёт, Query — выполняет запрос |
| Time | сколько секунд подключение в нынешнем состоянии |
| Info | текст запроса: первые 100 символов, а целиком — в SHOW FULL PROCESSLIST; |
Когда строк сотни, удобнее посчитать их по пользователям и состоянию:
SELECT user, command, COUNT(*) AS n
FROM information_schema.processlist
GROUP BY user, command ORDER BY n DESC;Закрыть одно подключение: KILL 12; — где 12 — число из столбца Id. Программа, которой принадлежало подключение, получит ошибку. Закрывайте только те подключения, про которые знаете, чьи они: можно оборвать резервное копирование или запись в базу.
Почему подключений так много
| Что видно в SHOW PROCESSLIST | Что это значит | Что сделать |
|---|---|---|
много строк Sleep от пользователя сайта, у части большое Time | программа открывает подключения и долго держит их без дела | уменьшить wait_timeout — раздел ниже |
много строк Query с большим Time | медленные запросы держат места, а новые подключения ждут | найти эти запросы через журнал медленных запросов |
| много строк с чужого адреса в столбце Host | к базе подключается программа с другого компьютера | проверьте, ваша ли это программа; если нет — смените пароль (как) |
много коротких Query от пользователя сайта | на сайт пришло много посетителей сразу | поднять max_connections и проверить, хватает ли памяти |
Каждое подключение занимает память сервера. Поэтому не ставьте предел в десятки тысяч «про запас»: поднимайте его до числа, которое видели на пике, с запасом.
Как поднять предел
Без перезапуска
В консоли базы:
SET GLOBAL max_connections = 300;
SHOW VARIABLES LIKE 'max_connections';Новое число действует сразу, но только до перезапуска базы. В MySQL вместо SET GLOBAL можно написать SET PERSIST max_connections = 300; — значение останется и после перезапуска. Подробнее о SET PERSIST — в статье настройки MySQL и MariaDB.
В файле настроек
- Откройте файл. MySQL:
sudo nano /etc/mysql/mysql.conf.d/mysqld.cnf. MariaDB:sudo nano /etc/mysql/mariadb.conf.d/50-server.cnf. - Найдите строку с max_connections: Ctrl+W, введите
max_connections, Enter. В MySQL там стоит# max_connections = 151, в MariaDB —#max_connections = 100. Решётка в начале значит, что строка выключена. - Уберите решётку и поставьте своё число:
max_connections = 300. - Сохраните файл: Ctrl+O, Enter, затем Ctrl+X.
- Перезапустите базу:
sudo systemctl restart mysqlдля MySQL илиsudo systemctl restart mariadbдля MariaDB. - Проверьте:
sudo systemctl status mysql(илиmariadb) должен показатьactive (running), а в консоли базыSHOW VARIABLES LIKE 'max_connections';— ваше число.
Число 100 в выключенной строке MariaDB — только пример из файла. Пока строка выключена, MariaDB принимает 151 подключение.
Если база не запустилась, откройте журнал ошибок: там будет строка с причиной.
Почему предел стал меньше заданного
В MySQL число подключений не может быть больше, чем предел открытых файлов минус 810. Если после перезапуска SHOW VARIABLES LIKE 'max_connections'; показывает меньше, чем вы записали, посмотрите этот предел:
SELECT @@open_files_limit;Например, при 1024 открытых файлах подключений будет не больше 214. В MariaDB предел подключений тоже связан с числом открытых файлов: чем больше подключений, тем больше файлов нужно базе.
Сколько ждёт подключение без дела
wait_timeout — через сколько секунд база сама закрывает подключение, которое ничего не делает. После установки это 28800 секунд, то есть 8 часов. Пока подключение висит в Sleep, оно занимает место.
- Посмотрите значение:
SHOW VARIABLES LIKE 'wait_timeout'; - Уменьшите, например до 10 минут:
SET GLOBAL wait_timeout = 600;Новое число получат только новые подключения, открытые уже после команды. - Чтобы значение осталось после перезапуска, запишите строку
wait_timeout = 600в раздел[mysqld]того же файла настроек.
Если программа держит подключение открытым дольше нового срока, при следующем запросе она получит ошибку о закрытом подключении. Поэтому меньшее значение проверьте на сайте.
Всё сверено с MySQL 8.0 и MariaDB 10.11 — эти версии ставятся в Ubuntu 24.04.
Источники
- Документация MySQL 8.0: Server System Variables — на английском: max_connections 151, от 1 до 100000, предел open_files_limit минус 810; wait_timeout 28800 секунд.
- Документация MySQL 8.0: Connection Interfaces — на английском: max_connections + 1 подключение для CONNECTION_ADMIN или SUPER, счётчик Connection_errors_max_connections.
- Документация MySQL 8.0: SHOW PROCESSLIST Statement — на английском: право PROCESS, первые 100 символов запроса, FULL, состояние Sleep, KILL.
- Документация MySQL 8.0: Server Status Variables — на английском: Max_used_connections и Threads_connected.
- Документация MySQL 8.0: SET Syntax for Variable Assignment — на английском: SET GLOBAL max_connections и SET PERSIST.
- Документация MariaDB: Server System Variables — на английском: max_connections 151, от 10 до 100000, запасное подключение для SUPER или CONNECTION ADMIN, связь с числом файлов.
- Документация MariaDB: Server Status Variables — на английском: Max_used_connections, Threads_connected, Connection_errors_max_connections.
- Файл mysqld.cnf из пакета mysql-8.0 в Ubuntu 24.04 — строка # max_connections = 151.
- Файл 50-server.cnf из пакета mariadb в Ubuntu 24.04 — строка #max_connections = 100.
Сверено 23 октября 2026 года.
Что почитать дальше
- Настройки MySQL и MariaDBгде лежат файлы и как применить настройку.
- innodb_buffer_pool_sizeсколько памяти дать базе.
- Журнал медленных запросовкакие запросы держат подключения дольше всех.
- PostgreSQL: sorry, too many clients alreadyта же беда в PostgreSQL.
- Redis: ERR max number of clients reachedта же беда в Redis.