Redis Script kill 命令（完整教程）

Redis Script kill 命令：处理阻塞脚本的“紧急制动”

在使用 Redis 时，我们常常会借助 Lua 脚本实现原子性操作。比如，同时读写多个键、判断条件再执行操作，这类场景非常适合用脚本处理。但你有没有遇到过这样的情况：一段 Lua 脚本运行了很长时间，甚至卡死在服务器上，导致其他请求无法响应？这时候，Redis 提供了一个“紧急制动”机制——Redis Script kill 命令，正是用来解决这类问题的关键工具。

想象一下，你正在开车，突然前方出现一辆故障车辆堵住了整条车道。你不能绕道，也无法停下，只能等它被移走。而 Redis Script kill 命令，就是那个能“强制移走故障车”的清障车。它不会修复脚本本身的问题，但能主动终止正在运行的、无法返回的脚本，释放 Redis 的资源，让系统恢复正常。

为什么需要 Redis Script kill 命令？

Redis 的脚本执行是单线程的。也就是说，一旦一个脚本开始运行，它会独占整个 Redis 实例，直到执行完毕或被中断。这在大多数情况下是安全的，因为 Lua 脚本设计为快速执行。但如果你写了一个死循环、或者执行了耗时极长的计算（比如遍历百万条数据），那 Redis 就会被“锁死”。

比如以下这段代码：

-- 示例：一个无限循环的脚本（千万不要这么写！）
local i = 0
while true do
    i = i + 1
    if i % 1000000 == 0 then
        redis.log(redis.LOG_WARNING, "正在运行... " .. i)
    end
end

这段脚本会一直运行下去，永远不会返回结果。Redis 无法处理任何其他请求，直到它自己“死掉”或被外部强制终止。

这时，Redis Script kill 命令就派上用场了。它能主动中断正在运行的、非只读的脚本，防止系统彻底瘫痪。

Redis Script kill 命令的使用条件

使用 Redis Script kill 命令并不是随时都能生效的。它有明确的使用限制，理解这些限制是安全操作的前提。

1. 脚本必须是正在运行的

只有那些已经进入执行状态、但尚未结束的脚本才能被终止。如果你尝试终止一个已经执行完毕的脚本，Redis 会返回错误。

2. 脚本不能是只读的

这是最关键的一点：只有写操作的脚本才能被 kill。如果脚本只读取数据（比如 redis.call('GET', 'key')），Redis 会拒绝终止它。

为什么？因为只读脚本不会修改数据状态，即使不结束，也不会造成数据不一致或资源阻塞。而写操作脚本如果长时间运行，可能已经修改了数据，但未提交，此时强行终止可能引发不一致。因此，Redis 保护机制只对“可能造成破坏”的脚本开放 kill 权限。

💡 比喻：只读脚本就像你在图书馆看书，不会动书架。而写操作脚本就像你在整理书架，如果中途被强制打断，可能书会掉下来。所以系统只允许“整理书架”的人被强制叫停。

3. 脚本不能是 SCRIPT KILL 本身

你不能用 SCRIPT KILL 来终止自己。这就像你不能用“关机”命令来关掉你正在执行的“关机”程序。

实际案例：模拟一个阻塞脚本并用 Redis Script kill 命令终止

下面我们通过一个真实场景来演示如何使用 Redis Script kill 命令。

步骤 1：启动 Redis 服务

确保你已安装 Redis 6.0 或以上版本（SCRIPT KILL 命令从 6.0 开始支持）。启动服务：

redis-server --port 6379

步骤 2：使用 Redis CLI 连接并执行一个阻塞脚本

打开另一个终端，连接到 Redis：

redis-cli -p 6379

然后执行以下 Lua 脚本（注意：这个脚本会无限循环，模拟阻塞）：

-- 这段脚本会无限循环，模拟一个“卡死”的脚本
-- 它会一直运行，直到被外部终止
redis.call('SET', 'blocking_key', '123')
local i = 0
while true do
    i = i + 1
    if i % 100000 == 0 then
        redis.log(redis.LOG_WARNING, "循环执行中... " .. i)
    end
end

在 Redis CLI 中执行：

EVAL "redis.call('SET', 'blocking_key', '123'); local i = 0; while true do i = i + 1; if i % 100000 == 0 then redis.log(redis.LOG_WARNING, '循环执行中... ' .. i) end end" 0

执行后，你会看到 Redis 无法响应其他命令，比如 PING、GET 都会卡住。

步骤 3：使用 Redis Script kill 命令终止脚本

在另一个终端中，再次连接 Redis CLI，执行：

SCRIPT KILL

如果脚本是可终止的（即包含写操作），Redis 会返回：

OK

表示脚本已被成功终止。

此时，你再尝试执行其他命令，Redis 会立刻恢复响应。

⚠️ 注意：如果脚本是只读的，执行 SCRIPT KILL 会返回错误：

(error) ERR You can't kill a read-only script

Redis Script kill 命令的返回值与错误处理

理解命令的返回值，是编写健壮脚本的重要一环。以下是 SCRIPT KILL 的常见响应：

这些错误信息非常清晰，有助于你判断当前状态。

实际代码示例（Python + redis-py）

如果你在 Python 中使用 redis-py 库，可以这样调用：

import redis

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

try:
    result = r.execute_command('SCRIPT', 'KILL')
    print("SCRIPT KILL 成功:", result)
except redis.ResponseError as e:
    print("错误:", e)

这个代码会捕获 SCRIPT KILL 的返回结果，并处理可能的异常。

如何避免需要使用 Redis Script kill 命令？

最好的防御就是避免问题发生。以下是一些实践建议：

1. 使用 SCRIPT LOAD + EVALSHA 分离脚本与执行

将脚本内容预先加载到 Redis，避免重复传输，同时便于管理：

SCRIPT LOAD "return redis.call('GET', 'key')"

返回 SHA1 值后，使用 EVALSHA 执行，提高性能。

2. 设置脚本超时时间

在 Redis 配置文件中设置 lua-time-limit（默认为 5000 毫秒，5 秒），超过这个时间，Redis 会自动中断脚本。

lua-time-limit 5000

📌 小贴士：这个值不能设置为 0，否则脚本将无法被中断。

3. 避免在脚本中使用无限循环或高耗时操作

如果必须遍历大量数据，请分批处理，或使用 SCAN 替代 KEYS。

4. 使用 redis.call('DEBUG', 'SLEEP', 1) 测试脚本执行时间

你可以用这个命令在脚本中模拟延迟，测试脚本是否在合理时间内完成。

总结：Redis Script kill 命令是运维的“救命稻草”

Redis Script kill 命令 不是日常操作的高频命令，但它在关键时刻能拯救整个系统。它就像 Redis 服务器的“紧急制动”按钮，当你发现某个脚本正在“失控”时，它能立即切断执行路径，防止雪崩。

记住几个关键点：

• 它只能终止包含写操作的、正在运行的脚本；
• 不能终止只读脚本；
• 必须在脚本未完成时使用；
• 配合 lua-time-limit 可以提前防范问题。

虽然我们不希望用到它，但一旦系统卡住，它就是你最可靠的“救火队员”。掌握它，才能真正驾驭 Redis 的强大能力。

最后提醒一句：写脚本时，多想想“如果出问题，能不能快速终止？”——这不仅是一种编程习惯，更是一种系统思维。