不能直接用set+expire两条命令，因网络往返和执行时序问题会导致脏数据；而复杂ip封禁需原子性多条件判断（如白名单检查、批量处理、返回结果），仅set ex无法满足，故必须用lua脚本保证一致性。
为什么不能直接用 SET + EXPIRE 两条命令？
因为网络往返和执行时序问题，SET ip:192.168.1.100 1 和 EXPIRE ip:192.168.1.100 3600 是两个独立操作：若第一条成功、第二条失败（如连接中断或Redis重启前未执行），就会留下永不过期的脏数据。Lua脚本在Redis单线程内原子执行，能彻底避免这个问题。
SET 命令加 EX 参数就足够了，为什么还要写Lua？
确实，SET ip:192.168.1.100 1 EX 3600 本身已原子化，但IP黑名单常需更复杂逻辑：
- 只在IP不存在时才设置（防覆盖已有不同过期时间的记录）→ 需
SETNX语义 - 统一管理多个IP批量封禁，且每条带独立TTL → 单条
SET无法批量处理 - 封禁前检查是否已在白名单中（需
SISMEMBER whitelist 192.168.1.100）→ 多key操作必须用Lua保证一致性 - 返回实际是否新增成功（而非仅OK），便于业务判断
这些场景下，手写Lua是必要选择。
一个安全可用的IP封禁Lua脚本长什么样？
以下脚本实现「若IP不在白名单中，则添加到黑名单并设TTL，返回1；否则返回0」：
local ip = KEYS[1]
local ttl = tonumber(ARGV[1])
local whitelist_key = ARGV[2]
if redis.call("SISMEMBER", whitelist_key, ip) == 1 then
return 0
end
redis.call("SET", "blacklist:" .. ip, "1", "EX", ttl)
return 1
调用方式（以redis-cli为例）：
redis-cli --eval /path/to/script.lua "192.168.1.100" , 3600 "whitelist"
Redis Skill - 高性能缓存管理
下载
Redis 缓存和数据结构管理技能。通过自然语言操作 Redis，支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。
注意点：
-
KEYS和ARGV必须严格分离，白名单key放在ARGV是因它不参与Redis key哈希槽路由，而IP作为KEYS[1]可被集群识别 - 不要用
redis.call("EXPIRE", ...)补充过期——这会破坏原子性，且SET ... EX更高效 - 如果用Redis 6+，可改用
SET ... NX EX组合实现“仅当不存在时设置”，但Lua仍不可少于多条件判断场景
生产环境容易忽略的三个细节
一是脚本加载后应使用 EVALSHA 而非重复 EVAL，降低网络开销和内存占用；可通过 SCRIPT LOAD 预存并缓存sha1值。
二是TTL单位必须是秒（EX），别错用毫秒（PX）——IP封禁通常按分钟/小时计，用错会导致过期时间差1000倍。
三是黑名单key命名建议带前缀（如 blacklist:192.168.1.100），避免和其它业务key冲突，也方便用 KEYS blacklist:*（仅开发环境）或 SCAN 管理。
真正麻烦的从来不是写几行Lua，而是把“判断逻辑”“key设计”“集群兼容”“运维可观测性”这几件事同时对齐。
