Поиск
Ошибки

Redis: ERR max number of clients reached

К Redis подключено столько клиентов, сколько разрешает настройка maxclients, — по умолчанию 10 000, и новые подключения он закрывает. Для небольшого сайта такое число говорит об утечке: приложение открывает подключения и не закрывает их.

≈ 6 мин чтения4 шага
Содержание 10

Как выглядит ошибка

(error) ERR max number of clients reached

Ответы Redis в программе redis-cli начинаются с (error). Приложение на PHP или Python показывает тот же текст без этой приставки, внутри своего сообщения об ошибке. Тексты сверены с исходным кодом Redis 7.0.15 — эта версия ставится из пакетов Ubuntu 24.04 — и Redis 8.0.5 из пакетов Ubuntu 26.04.

Redis отправляет этот ответ сразу после подключения и тут же закрывает соединение. Отказы он считает в строке rejected_connections — о ней ниже.

Почему подключений так много

Подключение занимает место в списке клиентов Redis, пока его не закроет приложение или сам Redis. В Ubuntu Redis молчащие подключения не закрывает: в redis.conf стоит timeout 0. Если приложение открывает новое подключение и не закрывает старое, они копятся, пока не дойдут до лимита.

Шаг 1. Освободите подключения

Пока лимит занят, redis-cli тоже не подключится. Перезапустите приложение, которое работает с Redis: когда процесс останавливается, его подключения закрываются. Для сайта на PHP в Ubuntu 24.04:

sudo systemctl restart php8.3-fpm

В Ubuntu 26.04 служба называется php8.5-fpm.

Для своего приложения — его службу, например sudo systemctl restart myapp. Если не знаете, какое приложение виновато, перезапустите Redis — он закроет все подключения:

sudo systemctl restart redis-server

sudo может спросить пароль вашего пользователя на сервере: символы при вводе не видны, наберите пароль и нажмите Enter.

Шаг 2. Посмотрите, кто держит подключения

Команды ниже набираются внутри redis-cli. Запустите его командой redis-cli, а если на Redis стоит пароль — redis-cli --askpass: программа спросит пароль и не покажет его на экране. Строка ввода станет 127.0.0.1:6379>. Выйти — команда exit.

INFO clients

Строка connected_clients — сколько подключено сейчас, maxclients — лимит. Команда INFO stats покажет строку rejected_connections — сколько подключений Redis отклонил с момента запуска. Теперь список подключений:

CLIENT LIST

Одна строка — одно подключение. Поле addr — адрес и порт клиента, age — сколько секунд подключение открыто, idle — сколько секунд оно молчит, cmd — последняя команда. Сотни строк с одним адресом и большим idle — подключения, которые приложение открыло и бросило.

Адрес 127.0.0.1 значит, что приложение на этом же сервере. Какой процесс держит подключения, покажет команда в терминале сервера — выйдите из redis-cli командой exit:

sudo ss -tnp | grep :6379

Смотрите строки, где адрес с :6379 стоит во второй колонке адресов: в конце такой строки в скобках имя процесса клиента, например php-fpm или node.

Шаг 3. Закрывайте молчащие подключения

Снова откройте redis-cli и выполните:

CONFIG SET timeout 300

Redis начнёт закрывать подключения, которые молчат дольше 300 секунд. Подключения подписки SUBSCRIBE и те, что ждут данных в BLPOP и похожих командах, timeout не трогает. Команда действует до перезапуска Redis. Чтобы настройка сохранилась, впишите её в файл. Файл настроек открывается так: sudo nano /etc/redis/redis.conf — как работать в nano. Найти строку в nano — Ctrl+W, сохранить — Ctrl+O и Enter, выйти — Ctrl+X.

Найдите строку timeout 0 и замените на:

timeout 300

Сохраните файл. Перезапускать Redis не нужно — значение уже действует. Если приложение после этого начнёт жаловаться на закрытое соединение, увеличьте число, например до 3600.

Шаг 4. Найдите причину в приложении

Тайм-аут убирает последствия. Причину ищите в приложении, которое держит больше всех подключений:

  • подключение к Redis создаётся в цикле или на каждый запрос и не закрывается;
  • у приложения много процессов, и каждый держит свой пул подключений большого размера.

Если подключений правда нужно больше

Если приложение работает правильно, а подключений нужно больше 10 000, поднимите лимит. Файл настроек открывается так: sudo nano /etc/redis/redis.conf — как работать в nano. Найти строку в nano — Ctrl+W, сохранить — Ctrl+O и Enter, выйти — Ctrl+X.

Найдите строку # maxclients 10000 и ниже допишите:

maxclients 20000

Сохраните файл и перезапустите Redis:

sudo systemctl restart redis-server

Служба redis-server в Ubuntu может открыть до 65 535 файлов, а Redis нужно на 32 больше, чем maxclients. Если лимит выше, Redis при запуске сам уменьшит его и напишет в журнал … maxclients has been reduced to ….

Как проверить

В redis-cli через час после исправления снова выполните INFO clients. Число connected_clients должно быть заметно меньше maxclients и не расти без конца.

Источники

Сверено 22 октября 2026 года.

Если не хочется держать базу на своём сервере. Есть облачные базы данных: MySQL, PostgreSQL или Redis без своего VPS, например в Timeweb Cloud Реклама. АО «ТАЙМВЭБ», ИНН 7810353960. erid: CQH36pWzJpoBWKF332yG5h2XQ4cVubfBmkvqAitFqcpzWs. Когда это выгоднее своего сервера, а когда нет, — в статье Сервер для базы данных.

Что почитать дальше