Redis Lua脚本必须严格使用KEYS/ARGV传参,禁止字符串拼接和loadstring,所有外部输入需校验类型、格式、长度,权限逻辑不得下放至Lua,上线前须SCRIPT LOAD预注册并白名单管控。

只允许用户输入走 ARGV/KEYS,禁止拼接进脚本体
Redis 的 Lua 沙箱不拦截字符串拼接或 loadstring,只要脚本里出现 loadstring("return "..ARGV[1]) 或 redis.call(cmd_name.."_ex", ...),攻击者就能传入恶意片段(比如 "1; os.execute('id')")触发逃逸。真实漏洞中,很多是开发者误以为“只要没用 eval 直接拼命令就行”,结果在脚本里用 .. 拼 key 名、拼条件表达式,把用户输入当代码执行了。
必须做到:
- 所有外部数据(IP、ID、用户名等)只能通过
KEYS或ARGV传入,且在 Lua 中仅作值使用 - 禁止任何形式的
loadstring、load、assert(load()) - 禁止用
..拼接出新命令名、新 key 名、新 Lua 表达式 - 若需动态 key(如
"user:"..id),必须由客户端算好后塞进KEYS或ARGV,而非在 Lua 里拼
对 ARGV 做类型校验和范围检查,别信“它只是个字符串”
redis.call("INCR", ARGV[1]) 看似安全,但如果 ARGV[1] 是 "123abc",会直接报 ERR value is not an integer or out of range;而 redis.call("GET", "user:"..ARGV[1]) 若传入 "123; DEL user:admin",虽然不会执行语句,但生成的 key 名可能被 SCAN 匹配逻辑误判,造成越权读取。
实操上必须:
- 数值类参数(如限流阈值、过期秒数)先用
tonumber(ARGV[1])转换,失败则return error("invalid number") - 字符串类参数(如用户名、token)用正则校验格式:
string.match(ARGV[1], "^[%w_]+$"),不匹配就拒绝 - 长度超限(如 >64 字符)或含控制字符(
\x00、\n)的参数直接 return 错误 - 避免用
pcall包裹关键调用做“试探性执行”,时序差异可能被用于信息泄露
权限与敏感逻辑不下沉,别让 Lua 脚本管“能不能做”
有人把用户鉴权、资源归属判断、金额校验这类强逻辑写进 Lua:读多个 key、比字段、返回布尔值。这等于把核心策略暴露在沙箱里——一旦沙箱被绕过(比如 CVE-2025-49844 这类 UAF 漏洞),攻击者就能直接篡改逻辑。
正确分工是:
- Lua 只做原子操作:增删改查、计数器自增、位数组置位、ZSET 时间戳维护
- 权限判断、业务规则、越界校验、错误响应组装,全部放在客户端或服务端完成
- 例如滑动窗口限流,Lua 只负责
ZADD+ZREMRANGEBYSCORE+ZCARD,是否放行由 Java/Python 根据返回值决定 - 布隆过滤器初始化也一样:Java 算好所有
bitOffset,Lua 只执行一批SETBIT,不参与哈希逻辑
上线前强制三道卡口:SCRIPT LOAD + 白名单 + 错误收敛
开发时用 EVAL 方便,但上线必须切到 EVALSHA 流程,否则每次请求都重编译脚本,既慢又绕过预检。而 NOSCRIPT 错误常因集群节点没同步 SCRIPT LOAD 导致,BUSYSCRIPT 则多因死循环或未设超时。
落地 checklist:
- 所有脚本上线前必须用
SCRIPT LOAD预注册,并在集群所有相关 slot 节点执行(或由客户端自动分发) - 应用层维护参数白名单:只允许特定 key pattern、固定长度的 ARGV、预定义的数值区间
- 脚本内禁止
redis.log(),生产环境关闭日志输出;错误统一返回{err: "xxx"}结构,不暴露 Redis 内部错误码 - 加基础防护:用
redis.call("time")做运行时超时检测,避免无限循环拖垮实例
最易被忽略的是:KEYS 声明不全导致集群路由失败,以及 ARGV 类型校验缺失引发的 OOM 或信息泄露——这两点在压测和灰度阶段极难复现,必须靠静态检查+强制校验兜底。











