Redis: OOM command not allowed when used memory > 'maxmemory'
Redis дошёл до лимита памяти maxmemory и не может освободить место, поэтому отказывает в записи. Чтение работает. Что делать, зависит от того, что лежит в Redis: кэш или данные, которые терять нельзя.
Содержание 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. Для кэша растущее число — норма.
Источники
- Исходный код Redis 7.0.15: server.c — тексты ответов с ошибками и строки журнала при запуске.
- Исходный код Redis 8.0.5: server.c — те же тексты в новой версии.
- Исходный код Redis 7.0.15: evict.c — как Redis удаляет ключи при достижении maxmemory и когда удалить нечего.
- Документация Redis: Key eviction — правила maxmemory-policy и строка evicted_keys.
- Исходный код Redis 7.0.15: redis-cli.c — ключи --bigkeys, --memkeys и --askpass.
- Файл redis.conf в Ubuntu 24.04 — значения по умолчанию: bind, protected-mode, порт, журнал, папка с данными.
Сверено 22 октября 2026 года.
Что почитать дальше
- Как установить Redis на Ubuntu.
- MISCONF: Redis не может сохранить данные на диск.
- Out of memory: Killed process.
- Все ошибки Redisтаблица по тексту сообщения.
- maxmemory в Redisлимит памяти и какие ключи удалять при лимите.
- Память Redis: INFO memoryсколько памяти занято и что такое фрагментация.
- Время жизни ключей RedisTTL, EXPIRE и PERSIST.