Redis Lua脚本中禁止使用SCAN命令，因其会中断执行流；应由客户端用SCAN分批获取key，再传入Lua批量处理，避免阻塞和超限。
SCAN在Lua脚本里根本不能用
Redis 的 Lua 脚本运行在单线程原子上下文中，SCAN 命令明确被禁止在 Lua 中调用——执行会直接报错 ERR This Redis command is not allowed from script。这不是权限或配置问题，是 Redis 内核的硬性限制：所有会“中断执行流”或“依赖游标状态”的命令（如 SCAN、SUBSCRIBE、CLIENT 等）一律屏蔽。想靠 Lua 封装分批遍历，这条路从底层就被堵死了。
大Key遍历必须拆到客户端做
安全可行的做法是把 SCAN 逻辑放在客户端，Lua 只承担“单次批量操作”的角色。典型流程是：客户端用 SCAN 拿一批 key（比如每次 100 个），拼成数组传给 Lua 脚本，脚本用 for 循环处理这批数据并返回结果。这样既避开 Lua 的命令限制，又避免网络往返放大（相比每个 key 单独发命令）。
- 客户端需维护游标（
cursor），首次调用SCAN 0 MATCH pattern COUNT 100，后续用返回的新游标继续 - Lua 脚本接收 key 列表作为
KEYS或ARGV参数，注意总长度别超 Redis 单次请求上限（默认 512MB，但实际建议控制在几 KB 内） - 脚本内避免用
redis.call("KEYS", "...")—— 这会阻塞主线程，且不支持模式匹配，更不可控
示例 Lua 片段（删除一批 hash field）：
Redis 缓存和数据结构管理技能。通过自然语言操作 Redis，支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。
for i = 1, #KEYS do
redis.call("HDEL", KEYS[i], unpack(ARGV))
end
遍历过程中 key 可能动态增减
SCAN 本身是**非原子快照**，执行期间其他客户端仍可增删 key。这意味着你可能漏掉刚写入的 key，或重复处理已被删除的 key（如果脚本里又重建了它）。这不是 bug，是设计使然。
- 若业务要求强一致性（比如迁移前必须 100% 覆盖），SCAN 不适用，得停写或用
KEYS（仅限小库且允许阻塞） - 若容忍少量偏差（如清理过期缓存），SCAN + 客户端重试（比如对失败 key 单独补操作）更实际
- 注意游标超时：SCAN 默认不超时，但某些 Redis 代理或中间件可能截断长连接，建议客户端加超时重连逻辑
大Hash/Set/List 遍历要用对应 SCAN 子命令
对容器类型的大 Key（比如含百万 field 的 hash），不能只 SCAN key 名，得进内部遍历。这时要用 HSCAN、SSCAN、ZSCAN —— 它们允许在 Lua 外部分批拉取元素，再传入 Lua 批量处理。
-
HSCAN myhash 0 COUNT 50返回 field-value 对，客户端解析后传给 Lua 做过滤或修改 - 避免在 Lua 里用
HELEN+HGETALL——HGETALL会一次性加载全部数据，内存和网络开销爆炸 - 如果字段名有规律（如时间戳前缀），优先用
HSCAN的MATCH参数缩小范围，减少传输量
真正麻烦的永远不是“怎么写”，而是“怎么确保不拖垮 Redis”——SCAN 游标要设合理 COUNT，客户端要有降级兜底（比如自动切到小批次或告警），还有监控游标是否卡住（长时间返回 cursor=0 且无数据，大概率 pattern 写错了）。
