Redis 中的 key 过期 (TTL) 如何工作？

Question

Accepted Answer

Redis 让 key 在设定的时间后**自动过期**（**TTL**——Time To Live），之后会被删除。这对缓存（使过期数据失效）、会话和任何临时数据都是基础性的，也是 Redis 最常用的特性之一。

## 设置过期时间

```bash
SET session:abc "data" EX 3600    # expire in 3600 seconds (1 hour)
SET key "value" PX 5000            # expire in 5000 milliseconds

# or set expiry on an existing key
SET cache:user:1 "..."
EXPIRE cache:user:1 300           # expire in 300 seconds
EXPIREAT key 1735689600           # expire at a specific Unix timestamp
```

创建 key 时设置 TTL（`EX`/`PX`）或之后添加（`EXPIRE`）。TTL 过期后，Redis 自动删除该 key。

## 检查和管理 TTL

```bash
TTL session:abc        # => seconds remaining (e.g. 3540), -1 if no expiry, -2 if gone
PTTL session:abc       # remaining time in milliseconds
PERSIST session:abc    # remove the expiry → make the key permanent
```

`TTL` 显示剩余时间（`-1` = 未设置过期，`-2` = key 不存在）；`PERSIST` 移除过期设置。

## Redis 如何让 key 过期

```text
Redis uses a combination of:
  LAZY expiration → when a key is accessed, if expired, it's deleted then
  ACTIVE expiration → a background process periodically samples and removes expired keys
→ So expired keys are cleaned up even if never accessed again (memory is reclaimed).
```

## TTL 的常见用途

```text
✓ CACHING — cache data with a TTL so it auto-refreshes (stale data expires)
✓ SESSIONS — sessions expire after inactivity (set/refresh TTL on activity)
✓ RATE LIMITING — a counter with a TTL (e.g. "max 100 requests per minute")
✓ TEMPORARY data — OTPs, tokens, locks that should auto-clean
→ TTL means Redis manages cleanup automatically — no manual deletion needed.
```

## 为什么这很重要

Key 过期 (TTL) 是 Redis 最重要和最常用的特性之一，因此理解它对于有效使用 Redis 至关重要，特别是对于缓存。

核心能力——key **在设定时间后自动删除**——是 Redis 最常见用例的基础：**缓存**（为缓存条目设置 TTL，使过期数据自动失效并刷新——这是几乎所有缓存策略的核心）、**会话**（在不活动后过期，活动时刷新 TTL）、**速率限制**（一个带 TTL 的计数器实现