Время жизни ключей Redis: TTL, EXPIRE и PERSIST
Ключу в Redis можно задать срок: когда он выйдет, Redis удалит ключ сам. Ключ без срока лежит, пока его не удалят или пока Redis не упрётся в лимит памяти. Здесь — как посмотреть, сколько ключу осталось жить, как задать и снять срок и почему ключи сайта копятся без срока.
Содержание 9
Что сделать прямо сейчас
- Подключитесь к серверу по SSH (как подключиться).
- Посмотрите, у скольких ключей есть срок:
redis-cli INFO keyspaceЕсли на Redis стоит пароль, пишите
redis-cli --askpassвместоredis-cli. - Сравните ответ с примером:
# Keyspace db0:keys=15234,expires=15100,avg_ttl=3412345keys— сколько всего ключей в базе 0,expires— у скольких из них есть срок. Еслиexpiresнамного меньшеkeys, ключи без срока копятся — что с ними делать, ниже. - Посмотрите, сколько осталось жить одному ключу:
redis-cli TTL имя_ключаОтвет — секунды.
-1— срока нет,-2— такого ключа нет. Имена ключей ищут через--scan— как найти ключи.
Что значат ответы TTL
| Ответ | Что значит |
|---|---|
(integer) 3540 | ключу осталось жить 3540 секунд, потом Redis удалит его сам |
(integer) -1 | ключ есть, срока нет: сам он не удалится |
(integer) -2 | такого ключа нет: не было, уже удалён или срок вышел |
TTL показывает секунды с округлением. Точнее, в миллисекундах, — PTTL имя_ключа. Ответы -1 и -2 у PTTL те же.
Когда именно ключ удалится, показывает EXPIRETIME имя_ключа — время в секундах от 1 января 1970 года. Перевести в дату: date -d @1793863200. Ответы -1 и -2 — как у TTL.
Если ответ -2, а ключ точно есть, проверьте номер базы: ключи сайта могут лежать не в базе 0. Для базы 1 — redis-cli -n 1 TTL имя_ключа, подробно — базы и ключи Redis.
Как задать срок
| Что нужно | Команда |
|---|---|
| задать срок ключу, который уже есть | EXPIRE имя_ключа 3600 — удалится через час |
| то же в миллисекундах | PEXPIRE имя_ключа 3600000 |
| удалить в заданный момент | EXPIREAT имя_ключа 1793863200 — время в секундах от 1970 года |
| записать ключ сразу со сроком | SET имя_ключа значение EX 3600 |
| то же в миллисекундах | SET имя_ключа значение PX 3600000 |
| перезаписать значение и оставить старый срок | SET имя_ключа значение KEEPTTL |
| прочитать ключ и заодно задать срок | GETEX имя_ключа EX 3600 |
EXPIRE отвечает (integer) 1, если срок поставлен, и (integer) 0, если такого ключа нет или не выполнено условие — о них ниже. Повторный EXPIRE заменяет старый срок новым.
Срок 0 или меньше Redis не хранит: EXPIRE с таким сроком или EXPIREAT с прошедшим временем удаляют ключ сразу. А в SET срок 0 или меньше — ошибка (error) ERR invalid expire time in 'set' command, ключ не записывается.
Условия NX, XX, GT и LT
С Redis 7.0 к EXPIRE, PEXPIRE, EXPIREAT и PEXPIREAT можно добавить условие. В Ubuntu 24.04 стоит Redis 7.0.15, условия работают.
| Условие | Когда Redis поставит срок |
|---|---|
NX | только если у ключа срока нет |
XX | только если срок уже есть |
GT | только если новый срок дальше старого |
LT | только если новый срок ближе старого |
Ключ без срока для GT и LT считается вечным. Поэтому EXPIRE имя_ключа 3600 GT на ключе без срока ответит 0 и ничего не поставит, а LT поставит.
Пример: продлить сессию на час, только если до конца осталось меньше часа:
EXPIRE sess:abc 3600 GTКогда срок пропадает
| Что сделали с ключом | Что стало со сроком |
|---|---|
SET без KEEPTTL, GETSET | срок снят: ключ записан заново, без срока |
DEL, UNLINK | ключа нет, срока нет |
SORT … STORE, SUNIONSTORE и другие команды с STORE | ключ записан заново, срок снят |
INCR, APPEND, LPUSH, HSET, SADD | срок остаётся: меняется значение, а не ключ |
RENAME старое новое | срок переходит к новому имени |
PERSIST имя_ключа | срок снят |
Ловушка: программа записала ключ со сроком, а потом перезаписала его командой SET без EX. Срок пропал, и ключ больше сам не удалится. Проверьте TTL такого ключа: если -1, программа пишет его без срока.
Как снять срок
PERSIST имя_ключаОтвет (integer) 1 — срок снят, ключ останется, пока его не удалят. (integer) 0 — срока не было или ключа нет.
Как Redis удаляет истёкшие ключи
Redis удаляет ключ с вышедшим сроком двумя путями:
- Когда к ключу обращаются. Программа просит ключ, Redis видит, что срок вышел, удаляет его и отвечает, что ключа нет.
- Сам, по расписанию. 10 раз в секунду Redis берёт по 20 случайных ключей со сроком и удаляет истёкшие. Пока среди проверенных больше 10 % истёкших, он берёт следующие 20. На эту работу Redis тратит не больше 25 % времени процессора.
Поэтому истёкший ключ не пропадает из памяти в ту же секунду, но программам он уже не виден. Сколько раз в секунду Redis проверяет ключи, задаёт строка hz 10 в /etc/redis/redis.conf, а dynamic-hz yes разрешает Redis поднимать это число, когда подключено много программ. Трогать эти строки не нужно.
Сколько ключей Redis удалил по сроку:
redis-cli INFO stats | grep -E '^expired|^evicted'| Строка | Что значит |
|---|---|
expired_keys | сколько ключей удалено по сроку с запуска Redis |
expired_stale_perc | примерная доля истёкших, но ещё не удалённых ключей, в процентах |
expired_time_cap_reached_count | сколько раз Redis не успел удалить все истёкшие ключи за отведённое время |
evicted_keys | сколько ключей Redis удалил сам из-за лимита памяти — это не срок, а maxmemory |
Срок Redis хранит как точное время окончания. Если часы сервера сдвинуть вперёд, ключи удалятся раньше. Проверить, что часы сервера сверяются сами: timedatectl, в ответе строка System clock synchronized: yes.
Ключи без срока копятся
Если в INFO keyspace expires намного меньше keys, большая часть ключей сама не удалится. Посмотрите, какие это ключи:
redis-cli --scan | head -n 20 | while read -r k; do echo "$(redis-cli TTL "$k") $k"; doneКоманда берёт первые 20 ключей базы и пишет перед каждым его TTL. Пример ответа:
-1 wp:posts:123
-1 wp:options:alloptions
1386 PHPREDIS_SESSION:0f3c9a7dКлючи с -1 записаны без срока. Если на Redis стоит пароль, перед командой выполните read -rs REDISCLI_AUTH и export REDISCLI_AUTH, а после — unset REDISCLI_AUTH: так пароль не придётся вводить для каждого ключа. Подробнее — redis-cli. Для базы 1 добавьте -n 1 к обоим redis-cli.
Чем это грозит: когда память Redis дойдёт до maxmemory, при политиках volatile-* Redis может удалять только ключи со сроком. Если таких нет, запись перестаёт работать с ошибкой OOM command not allowed. Какую политику выбрать — политики вытеснения.
WordPress: WP_REDIS_MAXTTL
Плагин Redis Object Cache записывает ключ со сроком, только если срок задал сам WordPress или другой плагин. Остальные ключи он пишет без срока. Ограничить срок можно константой WP_REDIS_MAXTTL, по умолчанию она 0 — без ограничения.
Чтобы все ключи кэша получили срок:
- Откройте wp-config.php сайта в nano — как работать в nano.
- Выше строки с надписью
That's all, stop editing!допишите, например, сутки — 86400 секунд:define( 'WP_REDIS_MAXTTL', 86400 ); - Сохраните файл: Ctrl+O, Enter, Ctrl+X.
После этого ключи без срока и ключи со сроком больше суток плагин пишет со сроком 86400 секунд. Уже записанные ключи это не меняет: они получат срок, когда плагин запишет их заново.
PHP-сессии в Redis
Если PHP хранит сессии в Redis (session.save_handler = redis), ключи называются PHPREDIS_SESSION:…. Срок им ставит сам PHP: он берёт его из строки session.gc_maxlifetime в php.ini и продлевает при каждом запросе, где сайт открывает сессию. В php.ini по умолчанию это 1440 секунд — 24 минуты.
Проверить, сколько у вас:
grep -n '^session.gc_maxlifetime' /etc/php/8.3/fpm/php.iniВ Ubuntu 26.04 вместо 8.3 — 8.5.
Ошибки и как их исправить
| Что видите | Причина | Что делать |
|---|---|---|
TTL отвечает (integer) -2, а ключ есть | ключ в другой базе | redis-cli -n 1 TTL имя_ключа — базы и ключи |
EXPIRE отвечает (integer) 0 | ключа нет или не выполнено условие NX, XX, GT, LT | проверьте EXISTS имя_ключа и TTL имя_ключа |
(error) ERR invalid expire time in 'set' command | в SET срок 0 или меньше | срок в EX и PX — больше нуля |
(error) ERR value is not an integer or out of range | вместо числа секунд — текст | EXPIRE имя_ключа 3600, без букв и пробелов в числе |
(error) ERR NX and XX, GT or LT options at the same time are not compatible | NX вместе с другим условием | оставьте одно условие |
(error) ERR GT and LT options at the same time are not compatible | GT и LT в одной команде | оставьте одно |
срок был, а теперь -1 | ключ перезаписали командой SET без EX | пишите SET … EX или SET … KEEPTTL |
| ключи пропадают раньше срока | Redis удаляет их из-за лимита памяти | evicted_keys в INFO stats, maxmemory |
| срок вышел, а память не уменьшилась | память Redis отдаёт системе не сразу | как вернуть память системе |
Все разборы — в разделе Ошибки Redis. Всё сверено с Redis 7.0.15 — эта версия ставится из пакетов Ubuntu 24.04. В Ubuntu 26.04 ставится Redis 8.0.5.
Источники
- Документация Redis: EXPIRE — на английском: условия NX, XX, GT, LT, когда срок снимается, RENAME, пассивное и активное удаление.
- Документация Redis: TTL — на английском: ответы -1 и -2.
- Документация Redis: PERSIST — на английском.
- Документация Redis: SET — на английском: EX, PX, EXAT, PXAT, KEEPTTL.
- Документация Redis: GETEX — на английском.
- Документация Redis: EXPIRETIME — на английском.
- Исходный код Redis 7.0.15: expire.c — 20 ключей за проход, 10 % истёкших, 25 % процессора, тексты ошибок условий, удаление при сроке 0.
- Исходный код Redis 7.0.15: networking.c — текст ошибки invalid expire time.
- Исходный код Redis 7.0.15: server.c — строки expired_keys, expired_stale_perc, evicted_keys и avg_ttl в INFO.
- Файл redis.conf в Ubuntu 24.04 — hz 10, dynamic-hz yes, политики volatile.
- Redis Object Cache 3.0.0: README — константа WP_REDIS_MAXTTL, по умолчанию 0.
- Redis Object Cache 3.0.0: object-cache.php — как плагин применяет WP_REDIS_MAXTTL.
- phpredis: README — сессии в Redis, срок из session.gc_maxlifetime.
- phpredis: redis_session.c — префикс PHPREDIS_SESSION:, запись через SETEX и продление через EXPIRE.
- PHP 8.3: php.ini-production — session.gc_maxlifetime = 1440.
Сверено 5 ноября 2026 года.
Что почитать дальше
- maxmemory в Redisлимит памяти и какие ключи Redis удаляет первыми.
- Базы и ключи Redisкак найти и удалить ключи.
- Память Redis: INFO memoryсколько памяти занимают ключи.