异常教程

Redis Evalsha 命令（长文解析）

更新时间:

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

截止目前， 星球 内专栏累计输出 90w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 3100+ 小伙伴加入学习 ，欢迎点击围观

前言

在 Redis 开发中，Lua 脚本因其原子性和高性能的特性，成为解决复杂业务场景的常用工具。而 Redis Evalsha 命令 是 Redis 提供的一种优化方案，用于快速执行已缓存的 Lua 脚本。本文将从基础概念、工作原理、实际案例和常见问题等角度，深入浅出地解析这一命令，并为开发者提供可复用的代码示例。

什么是 Redis Evalsha 命令？

与 Eval 命令的关系

Evalsha 是 EVAL 命令的“兄弟”命令，两者的核心功能都是执行 Lua 脚本。区别在于：

  • Eval 命令：每次执行时需要将完整的 Lua 脚本内容发送到 Redis 服务器，由服务器进行编译和缓存。
  • Evalsha 命令：直接使用脚本的 SHA1 哈希值引用已缓存的脚本，无需重复传输脚本内容。

形象比喻：
可以将 Eval 比作每次点餐时都向餐厅发送完整菜单，而 Evalsha 则像直接说出菜品编号——前者方便但效率低，后者高效但需要提前“注册”菜品。

核心语法与参数

Evalsha 的语法如下：

EVALSHA <sha1> <key_num> [key ...] [arg [arg ...]]

其中：

  • <sha1>：Lua 脚本的 SHA1 哈希值。
  • <key_num>：脚本操作的键数量。
  • [key ...]：具体键名。
  • [arg ...]：其他非键参数。

对比表格
（与前文空一行）
| 参数 | Eval 命令示例 | Evalsha 命令示例 |
|----------------|-------------------------------|-------------------------------|
| 脚本内容 | EVAL "..." 1 key arg | 无需脚本，仅需 SHA1 值 |
| 传输效率 | 高（需传输完整脚本） | 低（仅传输哈希值） |
| 缓存依赖 | 自动缓存脚本 | 依赖已有缓存的脚本 |

Evalsha 的工作原理

分步解析执行流程

  1. 脚本注册：首次使用 EVAL 执行脚本时，Redis 会计算其 SHA1 哈希值，并缓存该脚本。
  2. 哈希值获取：通过 SCRIPT EXISTS <sha1> 或首次 EVAL 的返回值，开发者可获取脚本的哈希值。
  3. Evalsha 调用：后续调用 EVALSHA 时，Redis 直接从缓存中加载对应脚本并执行。

缓存机制细节：
Redis 的脚本缓存是全局共享的，且不会因脚本未被调用而自动删除。因此，即使服务器重启，缓存会丢失，需重新注册脚本。

为什么 Evalsha 更高效？

  • 减少网络开销：哈希值仅 40 字节，而复杂脚本可能达到 KB 级，尤其在高并发场景下，传输效率提升显著。
  • 避免重复编译：Lua 脚本只需编译一次，后续执行直接加载已编译的字节码。
  • 降低内存占用：多个客户端调用同一脚本时，Redis 只需存储一份脚本副本。

场景适用性分析

Evalsha 适用于以下场景：

  • 频繁调用的短小脚本（如计数器、分布式锁）。
  • 需要高吞吐量的业务场景（如实时计费、排行榜更新）。
  • 脚本内容固定且不会频繁变更的场景。

不适用情况：

  • 脚本内容动态变化（如根据业务参数调整逻辑）。
  • 脚本执行频率极低（缓存的收益不明显）。

实战案例：分布式锁的实现

案例背景

分布式锁是多节点协作场景的常见需求。通过 Lua 脚本实现原子性加锁，结合 Evalsha 提升性能。

Lua 脚本设计

-- 加锁脚本：设置键值并设置过期时间  
local lock_key = KEYS[1]  
local identifier = ARGV[1]  
local expire_time = tonumber(ARGV[2]) or 0  

if redis.call("exists", lock_key) == 0 then  
    redis.call("set", lock_key, identifier, "px", expire_time)  
    return 1  
else  
    return 0  
end

Evalsha 调用流程

  1. 首次执行（通过 Eval）：
import redis  

client = redis.Redis(host='localhost', port=6379)  
script = """  
    if redis.call("exists", KEYS[1]) == 0 then  
        return redis.call("set", KEYS[1], ARGV[1], "px", ARGV[2])  
    else  
        return 0  
    end  
"""  
sha1 = client.script_load(script)  
print("Script SHA1:", sha1)  # 输出类似 b'9a2b3c4d...'
  1. 后续调用（通过 Evalsha）：
lock_key = "my_lock"  
identifier = "client_123"  
expire_ms = 10000  

result = client.evalsha(  
    sha1,  
    1, lock_key,  
    identifier, str(expire_ms)  
)  
print("Lock acquired:", bool(result))

错误处理与容错

若脚本未被缓存（如服务器重启后），Evalsha 会返回错误 NOSCRIPT no script。此时需：

  1. 重新注册脚本（通过 Eval）。
  2. 再次尝试 Evalsha。
try:  
    # 尝试执行 Evalsha  
except redis.exceptions.ResponseError as e:  
    if "NOSCRIPT" in str(e):  
        # 重新注册脚本  
        sha1 = client.script_load(script)  
        # 再次执行 Evalsha  
    else:  
        raise e

进阶技巧与常见问题

技巧 1：批量注册脚本

在应用启动时，可通过 SCRIPT LOAD 预加载常用脚本，避免首次调用 Eval 的延迟。

scripts = {  
    "lock_script": lock_lua_code,  
    "unlock_script": unlock_lua_code  
}  
for name, code in scripts.items():  
    scripts[name] = client.script_load(code)

技巧 2：动态生成哈希值

可通过本地计算 SHA1 值，避免首次调用 Eval 的往返延迟。

import hashlib  

def generate_sha1(script):  
    return hashlib.sha1(script.encode('utf-8')).hexdigest()  

script_sha = generate_sha1(lock_lua_code)

常见问题解答

Q1：Evalsha 返回空值或错误？

  • 检查 SHA1 值是否正确（区分大小写）。
  • 确认脚本已缓存，可通过 SCRIPT EXISTS <sha1> 验证。

Q2：如何处理脚本缓存过期？
Redis 的脚本缓存不会自动清理，但可通过 SCRIPT FLUSH 手动清除所有缓存。

Q3：Eval 与 Evalsha 的性能差异有多大？
在 100 字节脚本、千次/秒请求的场景下，Evalsha 可减少约 80% 的网络传输时间。

结论

Redis Evalsha 命令通过哈希值引用预编译的 Lua 脚本，显著提升了执行效率和系统吞吐量。无论是实现分布式锁、计数器还是复杂业务逻辑，开发者都可通过 Evalsha 获得更优的性能表现。

在实际开发中，建议遵循以下原则：

  1. 对高频脚本优先使用 Evalsha。
  2. 通过脚本预加载和本地 SHA1 计算优化初始化流程。
  3. 结合错误重试机制，确保脚本缓存缺失时的容错性。

通过本文的讲解和代码示例，开发者可以快速掌握 Redis Evalsha 命令 的核心用法，并将其应用到实际项目中，进一步释放 Redis 的性能潜力。

最新发布

查看更多文章