Redis Script Exists 命令（详细教程）

Redis Script Exists 命令：高效管理脚本哈希值的实用技巧

在现代分布式系统中，Redis 已经成为缓存、消息队列和会话存储的首选工具。然而，当你的应用需要执行复杂的原子操作时，单纯使用单条命令就显得力不从心了。这时候，Lua 脚本就派上了用场——它可以将多个 Redis 命令组合成一个原子操作，避免并发问题。

但问题也随之而来：如何确认某个脚本是否已经被加载到 Redis 的脚本缓存中？这就是我们要深入探讨的 Redis Script Exists 命令 的核心价值所在。

想象一下，你有一本厚厚的“操作手册”（Lua 脚本），每次执行前都要翻一遍。如果这本手册已经放在桌面上（缓存中），那就不用再找；如果不在，就得重新打印一份（加载）。Redis Script Exists 命令，就是帮你检查“手册”是否在桌面上的那个快速探查工具。

Redis Script Exists 命令的基本语法与作用

Redis Script Exists 命令用于检查一个或多个 Lua 脚本的 SHA1 哈希值是否存在于 Redis 的脚本缓存中。

它的基本语法如下：

SCRIPT EXISTS <sha1> [sha1 ...]

• <sha1>：一个或多个 Lua 脚本的 SHA1 哈希值。
• 返回值：一个布尔数组，每个元素对应输入的 SHA1 是否存在于缓存中。

📌 关键点：Redis 并不保存原始脚本内容，而是通过 SHA1 哈希值来识别脚本。这意味着，即使两个脚本内容不同，只要哈希值相同（理论上极小概率），就会被当作同一个脚本处理。

举个实际例子：

假设你有一个脚本，用于原子性地增加用户积分并更新最后活跃时间：

-- 脚本内容：add_user_score.lua
local user_id = KEYS[1]
local increment = tonumber(ARGV[1])
local current_score = redis.call("GET", user_id)
if current_score == false then
    current_score = 0
end
current_score = current_score + increment
redis.call("SET", user_id, current_score)
redis.call("HSET", "user:last_active", user_id, redis.call("TIME")[1])
return current_score

你可以用 redis-cli 通过 SCRIPT LOAD 命令将其加载到 Redis 缓存中，并获取其 SHA1 哈希值：

redis-cli SCRIPT LOAD "local user_id = KEYS[1] ... return current_score"

假设返回结果为：a1b2c3d4e5f678901234567890abcdef12345678

接着，就可以使用 SCRIPT EXISTS 检查这个脚本是否已缓存：

redis-cli SCRIPT EXISTS a1b2c3d4e5f678901234567890abcdef12345678

返回结果：

1

表示该脚本已存在于缓存中，下次可以直接通过 EVALSHA 执行，无需再次传输脚本内容。

为什么需要检查脚本是否已存在？

在生产环境中，频繁传输 Lua 脚本会导致网络开销和延迟增加。Redis 会缓存已加载的脚本，避免重复传输。但如果你不知道脚本是否已缓存，就可能造成资源浪费。

举个比喻：

想象你在一家连锁餐厅点餐。如果你每次都让厨师重新写下菜单（相当于重新 LOAD 脚本），效率很低。但如果菜单已经贴在墙上（缓存中），你只需告诉服务员“我要那份辣子鸡”，就能快速上菜（EVALSHA 执行）。

而 Redis Script Exists 就像是你进门时先看一眼墙上有没有菜单，决定是否需要重新点单。

多脚本批量检查：一次调用多个 SHA1

SCRIPT EXISTS 支持同时检查多个脚本的缓存状态，非常适用于批量部署或维护场景。

redis-cli SCRIPT EXISTS a1b2c3d4e5f678901234567890abcdef12345678 b2c3d4e5f678901234567890abcdef12345678 c3d4e5f678901234567890abcdef12345678

返回结果：

1
1
0

表示前两个脚本已缓存，第三个尚未加载。

这个功能在自动化部署中特别有用。例如，你的系统在启动时需要加载多个业务脚本，可以先用 SCRIPT EXISTS 批量检查，只对未缓存的脚本执行 SCRIPT LOAD，从而节省时间和带宽。

实际应用案例：构建脚本管理工具

下面是一个 Python 脚本示例，演示如何用 Python 客户端（redis-py）实现脚本缓存状态的检查与自动加载。

import redis
import hashlib

client = redis.Redis(host='localhost', port=6379, db=0)

scripts = [
    """
    local key = KEYS[1]
    local value = tonumber(ARGV[1])
    local current = redis.call("GET", key)
    if not current then current = 0 end
    current = current + value
    redis.call("SET", key, current)
    return current
    """,
    """
    local key = KEYS[1]
    local expire = tonumber(ARGV[1])
    redis.call("SET", key, "1")
    redis.call("EXPIRE", key, expire)
    return "OK"
    """
]

script_hashes = []
for script in scripts:
    # 使用 SHA1 对脚本内容进行哈希
    sha1 = hashlib.sha1(script.encode('utf-8')).hexdigest()
    script_hashes.append(sha1)

exists_results = client.script_exists(*script_hashes)

for i, (script, exists) in enumerate(zip(scripts, exists_results)):
    if exists:
        print(f"脚本 {i+1} 已缓存，SHA1: {script_hashes[i]}")
    else:
        print(f"脚本 {i+1} 未缓存，将尝试加载...")
        # 加载脚本
        loaded_hash = client.script_load(script)
        print(f"脚本已成功加载，SHA1: {loaded_hash}")

✅ 注释说明：

• hashlib.sha1(script.encode('utf-8')).hexdigest()：对 Lua 脚本内容生成 SHA1 哈希，确保与 Redis 内部一致。
• client.script_exists(*script_hashes)：使用解包操作传入多个哈希值。
• client.script_load(script)：将脚本内容加载到 Redis 脚本缓存中，并返回其 SHA1。

常见误区与最佳实践

误区一：误以为 SCRIPT EXISTS 能检查脚本内容

SCRIPT EXISTS 只能根据 SHA1 哈希判断缓存状态，不能验证脚本内容是否正确。如果两个脚本哈希相同（哈希冲突，理论上几乎不可能），会被当作同一个脚本处理。

误区二：忽略脚本缓存的生命周期

Redis 会自动管理脚本缓存，但当缓存占用过多内存时，可能会被驱逐。因此，不要假设脚本一定在缓存中。每次使用 EVALSHA 前，建议先用 SCRIPT EXISTS 检查。

最佳实践建议：

与其他脚本命令的配合使用

Redis Script Exists 命令 并不是孤立存在的。它常与以下命令配合使用，构成完整的脚本管理流程：

示例：安全执行脚本流程

redis-cli SCRIPT EXISTS a1b2c3d4e5f678901234567890abcdef12345678

redis-cli EVALSHA a1b2c3d4e5f678901234567890abcdef12345678 1 user:100 10

redis-cli EVAL "local user_id = KEYS[1]; ... return 1" 1 user:100 10

💡 提示：在代码中应优先使用 EVALSHA，只有在 SCRIPT EXISTS 返回 0 时才 fallback 到 EVAL。

总结：Redis Script Exists 命令的价值

Redis Script Exists 命令 虽然看似简单，但在实际生产中扮演着“脚本状态守门人”的角色。它帮助我们：

• 避免重复加载脚本，降低网络开销；
• 提升脚本执行效率，实现更高效的原子操作；
• 构建健壮的脚本管理机制，防止因缓存缺失导致的运行错误。

对于初学者来说，理解这个命令是掌握 Redis 脚本机制的重要一步；对于中级开发者，它是构建高性能、高可用系统的关键工具之一。

当你在项目中遇到“脚本执行失败”或“延迟过高”的问题时，不妨先用 SCRIPT EXISTS 检查一下缓存状态——也许答案就在那短短的一行返回值中。