Поиск
Справочник

Время жизни ключей Redis: TTL, EXPIRE и PERSIST

Ключу в Redis можно задать срок: когда он выйдет, Redis удалит ключ сам. Ключ без срока лежит, пока его не удалят или пока Redis не упрётся в лимит памяти. Здесь — как посмотреть, сколько ключу осталось жить, как задать и снять срок и почему ключи сайта копятся без срока.

≈ 10 мин чтения
Содержание 9

Что сделать прямо сейчас

  1. Подключитесь к серверу по SSH (как подключиться).
  2. Посмотрите, у скольких ключей есть срок:
    redis-cli INFO keyspace

    Если на Redis стоит пароль, пишите redis-cli --askpass вместо redis-cli.

  3. Сравните ответ с примером:
    # Keyspace
    db0:keys=15234,expires=15100,avg_ttl=3412345

    keys — сколько всего ключей в базе 0, expires — у скольких из них есть срок. Если expires намного меньше keys, ключи без срока копятся — что с ними делать, ниже.

  4. Посмотрите, сколько осталось жить одному ключу:
    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 удаляет ключ с вышедшим сроком двумя путями:

  1. Когда к ключу обращаются. Программа просит ключ, Redis видит, что срок вышел, удаляет его и отвечает, что ключа нет.
  2. Сам, по расписанию. 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 — без ограничения.

Чтобы все ключи кэша получили срок:

  1. Откройте wp-config.php сайта в nano — как работать в nano.
  2. Выше строки с надписью That's all, stop editing! допишите, например, сутки — 86400 секунд:
    define( 'WP_REDIS_MAXTTL', 86400 );
  3. Сохраните файл: 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 compatibleNX вместе с другим условиемоставьте одно условие
(error) ERR GT and LT options at the same time are not compatibleGT и 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.

Источники

Сверено 5 ноября 2026 года.

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

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