Поиск
Ошибки

Redis: OOM command not allowed when used memory > 'maxmemory'

Redis дошёл до лимита памяти maxmemory и не может освободить место, поэтому отказывает в записи. Чтение работает. Что делать, зависит от того, что лежит в Redis: кэш или данные, которые терять нельзя.

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

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

(error) OOM command not allowed when used memory > 'maxmemory'.

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

Ошибку получают команды, которые добавляют данные: SET, LPUSH, HSET и другие. Чтение (GET) и удаление (DEL) работают.

Почему так происходит

Ошибка возможна, только если в redis.conf задан лимит maxmemory. Когда память дошла до лимита, Redis пробует удалить ключи по правилу из строки maxmemory-policy. Удалить нечего в двух случаях:

  • правило noeviction — Redis ничего не удаляет. Оно действует, если строки maxmemory-policy в файле нет: в redis.conf Ubuntu она закомментирована;
  • правило начинается с volatile- — Redis удаляет только ключи со сроком жизни (TTL), а таких ключей не осталось.

Если строки maxmemory нет, лимита нет и этой ошибки не будет: Redis займёт память, пока она не кончится на сервере, и тогда его может завершить ядро — Out of memory: Killed process.

Шаг 1. Посмотрите память Redis

Команды на этой странице вводятся на сервере: подключитесь к нему по SSH (как подключиться) и набирайте их в том же окне.

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

INFO memory

В длинном ответе нужны три строки:

СтрокаЧто значит
used_memory_humanсколько памяти занимают данные Redis
maxmemory_humanлимит из строки maxmemory; 0B — лимита нет
maxmemory_policyчто Redis делает, когда лимит достигнут

Сколько ключей со сроком жизни:

INFO keyspace

Ответ вида db0:keys=1520,expires=0,avg_ttl=0: keys — всего ключей, expires — ключей со сроком жизни. Если expires равно 0, правилам volatile- удалять нечего.

Шаг 2. Решите, что делать

Что лежит в RedisЧто делать
кэш: WordPress с плагином Redis Object Cache, кэш Laravelвключите правило allkeys-lru — Redis сам будет удалять давно не нужные ключи, шаг 3
очереди задач, сессии, данные, которые нельзя терятьподнимите лимит или найдите, что заняло память, — шаг 4. Правила allkeys- удалят и нужные ключи

Шаг 3. Для кэша: включите удаление старых ключей

В redis-cli включите правило сразу, без перезапуска:

CONFIG SET maxmemory-policy allkeys-lru

Ответ OK — запись снова работает. Чтобы правило осталось после перезапуска Redis, впишите его в файл настроек. Файл настроек открывается так: sudo nano /etc/redis/redis.conf — как работать в nano. Найти строку в nano — Ctrl+W, сохранить — Ctrl+O и Enter, выйти — Ctrl+X.

Найдите строку # maxmemory-policy noeviction и ниже допишите:

maxmemory-policy allkeys-lru

Сохраните файл. Перезапускать Redis сейчас не нужно: правило уже включено командой CONFIG SET, а файл Redis прочитает при следующем запуске. Подробнее о лимите и правиле — лимит памяти для кэша.

Шаг 4. Поднимите лимит или найдите, что заняло память

Посмотрите, сколько памяти свободно на сервере, — команда free:

free -h

Если память есть, поднимите лимит в redis-cli, например до 512 МБ:

CONFIG SET maxmemory 512mb

И поменяйте на то же значение строку maxmemory в /etc/redis/redis.conf — так лимит сохранится после перезапуска. Оставьте память сайту, базе данных и системе: если Redis займёт всю память сервера, ядро начнёт завершать программы.

Найти самые большие ключи можно командой в терминале сервера — выйдите из redis-cli командой exit:

redis-cli --bigkeys

Программа пройдёт по всем ключам и покажет самый большой ключ каждого типа. Команда redis-cli --memkeys ищет ключи, которые занимают больше всего памяти. Если на Redis стоит пароль, добавьте --askpass: redis-cli --askpass --bigkeys.

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

В redis-cli запишите и удалите пробный ключ:

SET proverka 1
DEL proverka

Ответы OK и (integer) 1 — запись работает. Сколько ключей Redis удалил по правилу, показывает строка evicted_keys в ответе команды INFO stats. Для кэша растущее число — норма.

Источники

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

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

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