redis KEYS 使用说明

封面图 • 2025-10-17 • redis

在 Redis 中，`KEYS` 是一个用于查找所有匹配给定模式的键的命令。虽然它非常有用，但在生产环境中使用时需要格外小心，因为它可能会对性能造成严重影响。

---

## ✅ `KEYS` 命令的基本语法：

```bash
KEYS pattern
```

- **pattern**：一个 glob 风格的模式（类似正则表达式），用于匹配键名。
  - `*` 匹配任意数量的字符（包括零个）。
  - `?` 匹配单个字符。
  - `[abc]` 匹配括号中的任意一个字符。
  - `[a-z]` 匹配 a 到 z 的任意一个字符。
  - `\x` 转义字符（如 `\*` 表示实际的星号）。

---

## 🔍 示例

### 1. 查找所有键：
```bash
KEYS *
```
> 返回 Redis 中所有的键（不推荐在大型数据库中使用）。

### 2. 查找以 `user:` 开头的键：
```bash
KEYS user:*
```

### 3. 查找以 `user:` 开头，后面跟着数字的键：
```bash
KEYS user:[0-9]*
```

### 4. 查找包含 `session` 的键：
```bash
KEYS *session*
```

---

## ⚠️ 注意事项

### 1. **性能问题**
- `KEYS` 命令会遍历整个键空间，时间复杂度为 O(N)，其中 N 是键的数量。
- 在有大量键的 Redis 实例中，这个命令可能导致严重的性能问题甚至阻塞。

### 2. **生产环境建议**
- 不要使用 `KEYS` 来查找大量键。
- 如果你需要进行模糊查询或批量删除操作，可以考虑以下替代方案：

#### ✅ 替代方案：

| 操作 | 推荐方式 |
|------|----------|
| 删除所有匹配的键 | 使用 `SCAN` + `DEL` 或 `UNLINK` |
| 查询所有匹配的键 | 使用 `SCAN` 迭代器逐步获取 |

---

## 🔄 `SCAN` 命令（推荐）

`SCAN` 是一个迭代器命令，用于安全地遍历键空间，避免一次性加载所有数据到内存中。

### 语法：

```bash
SCAN cursor [MATCH pattern] [COUNT count]
```

### 示例：查找所有以 `user:` 开头的键

```bash
SCAN 0 MATCH user:* COUNT 100
```

- `cursor`：游标，初始值为 `0`。
- `MATCH`：匹配模式。
- `COUNT`：每次返回的元素数量（默认是 10）。

你可以通过循环调用 `SCAN` 直到游标变为 `0`，从而逐批获取所有匹配的键。

---

## 🧠 总结

| 命令 | 说明 | 是否推荐 |
|------|------|----------|
| `KEYS` | 查找所有匹配键 | ❌ 不推荐在生产环境中使用 |
| `SCAN` | 安全地遍历键空间 | ✅ 推荐使用 |

---

如果你有具体的使用场景或遇到性能问题，欢迎继续提问！