Redis Lua 长脚本怎么拆：保留短状态变更并控制单次批量

Redis Lua 脚本变慢时，先别急着把所有逻辑拆回应用层：它的价值是把多条读写放进一次服务端执行，减少网络往返并保持原子性；它的代价是脚本运行期间 Redis 的其他服务活动都会等待。因此真正要收敛的不是“Lua 能不能用”，而是每次执行要处理多少数据、占用主线程多久，以及慢调用能否被定位。

把脚本限制成短小、参数化且有上限的状态变更，再用 SLOWLOG 和延迟历史验证；只要计算量不可控，就把计算移出 Redis。

本文先给结论：键名全部放进 KEYS，普通参数放进 ARGV；循环必须有硬上限；重复调用优先使用缓存脚本；监控既看脚本慢调用，也看业务端到端延迟。

先确认：Lua 的原子性为什么会放大延迟

Redis 文档对脚本语义有一个容易被忽略的限定：脚本执行的整个期间，服务器活动会被阻塞。原子性表示脚本的效果不会被另一条命令插入，并不表示脚本内部计算可以并行。一个包含大范围遍历、长字符串处理或无界循环的脚本，越“原子”，越可能把单线程等待时间集中到一次请求上。

先把边界画清楚：调用方负责传入键和参数，Lua 执行域负责条件判断与有限次 Redis 命令，数据键是脚本实际读写的对象。不要在脚本中拼接键名，也不要从集合内容动态推导要访问的键；这既不利于审查，也会破坏集群场景下的键路由约束。

把脚本改成有界的原子操作

以“从待处理列表取出一小批任务”为例，脚本可以保留检查和弹出的一致性，但不应允许调用方传入任意大的批量值：

-- KEYS[1]：待处理列表；ARGV[1]：本次最多取几条
local limit = tonumber(ARGV[1])
if not limit or limit  100 then
    return redis.error_reply("batch limit must be 1..100")
end

local available = redis.call("LLEN", KEYS[1])
local count = math.min(available, limit)
local result = {}
for i = 1, count do
    result[i] = redis.call("LPOP", KEYS[1])
end
return result

这里的重点不是把 100 当成通用最佳值，而是让上限成为可讨论、可压测的参数。若单条任务很重，应进一步降低批量，或只在 Lua 中确认并标记任务，把耗时计算交给消费者。脚本也要尽量参数化，避免每次动态生成一份新源码；源码变化会增加缓存条目和解析开销。

用 SLOWLOG 和延迟历史验证收敛结果

修改前后至少保留三组观测：脚本自身的慢调用、实例延迟事件、业务请求的端到端耗时。可以先查看最近的慢日志：

SLOWLOG GET 20
LATENCY LATEST

SLOWLOG 适合确认某次命令或脚本是否超过配置的慢日志阈值；LATENCY HISTORY 则适合沿时间观察某类延迟事件。两者都不能单独证明“用户体验变好了”，还要把客户端超时、重试和队列等待纳入业务指标。如果慢日志消失但 P99 仍高，通常说明瓶颈已经移到了连接池、网络或脚本前后的排队。

重复发送同一脚本时，可先加载再按 SHA 执行：

SCRIPT LOAD "return redis.call('LLEN', KEYS[1])"
EVALSHA  1 queue:pending

脚本缓存不是持久数据，重启、故障切换或 SCRIPT FLUSH 后可能丢失。客户端收到 NOSCRIPT 时应重新加载后再执行；流水线场景尤其要确认客户端是否能安全处理这个回退。

什么时候应该放弃 Lua

出现以下任一情况，就不宜继续给脚本堆逻辑：循环规模由集合大小决定且无法设上限；单次调用需要扫描大量键或做复杂字符串计算；脚本只是为了拼装多个独立查询；或者业务允许最终一致，不需要把所有动作锁在同一原子域。此时可以把数据读取和计算移到应用或后台消费者，只把“检查版本、扣减计数、写入状态”保留为短脚本。

小结：原子性解决的是并发插入问题，不是性能免费券；KEYS/ARGV 解决输入边界，有界循环解决执行上限，SLOWLOG 与延迟历史解决结果判断，EVALSHA 解决重复传输。每次优化都要回答“脚本少占了多少主线程时间”，而不是只看代码行数。

相关问题

Redis Cluster 中 Lua 可以访问多个键吗？可以，但脚本访问的键必须显式作为 KEYS 传入，并且集群场景下相关键通常需要位于同一 hash slot；设计键名时应提前规划 hash tag。

脚本超时后能不能强制杀掉？Redis 提供 SCRIPT KILL，但它主要适用于尚未修改数据的只读脚本。写入中的长脚本不能随意中断，否则会破坏原子性预期；更稳妥的办法是从源头限制工作量。

参考资料：Redis Lua scripting、SLOWLOG、LATENCY HISTORY。