Redis 中的 Lua 脚本如何工作？

Question

Accepted Answer

Redis 可以在服务器端执行 **Lua 脚本** — 以单个 **atomic** 操作的形式运行多个命令。脚本可以实现复杂的原子逻辑、减少网络往返，是在 Redis 中执行多步原子操作的推荐方式。

## 运行 Lua 脚本

```bash
# EVAL runs a Lua script; KEYS[] and ARGV[] pass keys and arguments
EVAL "return redis.call('SET', KEYS[1], ARGV[1])" 1 mykey myvalue

# a script can run multiple commands and logic atomically
EVAL "
  local current = redis.call('GET', KEYS[1])
  if current == ARGV[1] then
    return redis.call('DEL', KEYS[1])   -- delete only if value matches (atomic check-and-delete)
  end
  return 0
" 1 lock:resource mytoken
```

脚本使用 `redis.call()` 运行命令，传入 `KEYS[]`（键名）和 `ARGV[]`（参数）。整个脚本 **atomically** 作为一个单元执行。

## 脚本为什么是原子的以及为什么有用

```text
✓ ATOMICITY — the ENTIRE script runs as one unit, no other commands interleave
  → perfect for read-modify-write logic that must be atomic (locks, conditional updates,
    rate limiting, complex counters) — better than MULTI/EXEC for conditional logic
✓ FEWER ROUND-TRIPS — multiple operations in ONE call to Redis (less network latency)
✓ Custom LOGIC server-side — conditionals, loops, computations near the data
```

## EVALSHA — 缓存脚本

```bash
# load a script once, then call by its SHA hash (avoids resending the script each time)
SCRIPT LOAD "return redis.call('GET', KEYS[1])"   # => returns a SHA1 hash
EVALSHA <sha> 1 mykey                              # run the cached script by hash
```

`EVALSHA` 通过脚本的哈希值运行先前加载的脚本 — 对于频繁使用的脚本很高效（脚本在服务器端被缓存）。

## 注意事项

```text
⚠️ Scripts BLOCK the server while running (Redis is single-threaded) → keep them FAST
   and simple (no slow loops/operations — they'd stall ALL clients)
⚠️ Scripts should be deterministic; pass keys via KEYS[] (for cluster correctness)
→ Use scripts for short, atomic logic — not heavy computation.
```

## 为什么这很重要

Redis 中 Lua 脚本的知识对于 **执行复杂的原子操作** 来说是宝贵的高级知识，因此对于高级 Redis 使用很有用。

核心价值是 **多步逻辑的原子性**：Lua 脚本 **完全作为一个原子单元执行**（没有其他命令交错），使其成为执行必须是原子的读-修改-写操作的推荐方式 — 例如条件更新、安全锁释放（仅当令牌匹配时删除）、速率限制和复杂计数器 — 通常比 `MULTI`/`EXEC` 更好，因为脚本支持 **条件逻辑**（事务无法根据中间读取做出决策，但脚本可以）。

这解决了比单个命令更复杂的原子操作的真实需求。

次要好处是 **更少的网络往返**（多个操作在一次调用中，降低延迟）和运行 **自定义服务器端逻辑**（靠近数据）。

理解 **`EVALSHA`**（通过哈希缓存脚本以避免重新发送）是频繁使用的脚本的一个实用效率技术。

Critically，理解 **注意事项** 很重要：脚本在运行时 **阻止单线程服务器**，因此必须保持快速和简单（慢脚本会阻塞所有客户端 — 真实的性能危害），脚本应该是确定性的，通过 `KEYS[]` 传入键（为了集群正确性）。

这种认识可以防止将脚本滥用于繁重计算。

Since 复杂的原子操作是一个真实需求（锁、条件逻辑、原子多步更新），并且 Lua 脚本提供原子、单轮往返、服务器端逻辑，这是推荐的方式（具有关于阻塞的重要注意事项），理解 Lua 脚本 — 它的工作原理、为什么它是原子和有用的、EVALSHA 缓存以及保持快速的注意事项 — 是高级 Redis 使用的宝贵高级知识，是原子多步逻辑的正确工具，也是反映更深层次 Redis 专业知识的主题。