redis lua脚本能保证原子性是因为其在单线程中串行执行，不被其他命令打断；脚本内redis命令直入执行队列，避免网络解析；须避免耗时操作以防阻塞，keys需显式声明以支持集群，argv传任意参数，调试依赖日志与本地验证。
Redis Lua脚本为什么能保证原子性
因为 Redis 执行 EVAL 或 EVALSHA 时，整个脚本在单个 Lua 解释器中串行执行，期间不会被其他客户端命令打断——这不是靠锁实现的，而是 Redis 的单线程命令调度模型天然赋予的特性。注意：脚本内调用的 Redis 命令（如 redis.call("GET", "key")）会直接进入内部执行队列，不经过网络解析和排队环节。
必须避免在 Lua 脚本里做耗时操作
一旦脚本执行时间过长，会阻塞所有后续请求，严重时触发 SCRIPT_KILL 或超时断连。常见踩坑点包括：
- 用
for循环遍历大量 key（比如上万次redis.call("HGET", ...)） - 在脚本里做字符串拼接、正则匹配或 JSON 解析（Lua 原生不支持 JSON，
cjson模块虽可用但慢） - 调用
redis.call()以外的网络或文件 I/O（根本不可用，会报错@user_script:...: user_script:1: attempt to call a nil value）
建议把数据预处理放在客户端，Lua 脚本只做“读-算-写”三步内的轻量逻辑。
KEYS 和 ARGV 参数怎么安全传入脚本
KEYS 必须是真实存在的 key 名，不能是拼接出来的变量；Redis 会校验这些 key 是否属于当前节点（集群模式下尤其关键）。而 ARGV 是任意字符串，适合传数值、flag、序列化结构等。
错误写法：local key = "prefix:" .. ARGV[1]; redis.call("GET", key) —— 这会让 Redis 无法提前识别 key，集群模式直接报错 CROSSSLOT Keys in request don't hash to the same slot。
正确写法示例（原子性增减并限流）：
EVAL "if redis.call('EXISTS', KEYS[1]) == 0 then redis.call('SET', KEYS[1], ARGV[1], 'EX', ARGV[2]); return 1 else return 0 end" 1 my:lock:123 123 30
这里 KEYS[1] 明确声明了 key，ARGV[1] 和 ARGV[2] 分别是值和过期秒数。
调试 Lua 脚本时怎么快速定位错误
Redis 不提供行号级错误堆栈，报错信息往往只显示 @user_script:3: ...。实际调试建议：
- 先在本地用
lua5.1（或luajit）跑通逻辑，注意 Redis 内置 Lua 环境没有print、os.time、math.random等函数 - 用
redis.log(redis.LOG_WARNING, "debug: "..val)输出到 Redis 日志（需配置loglevel warning及以上） - 检查返回值类型：Lua 中
nil和false都会被转成 Redis 的空回复，容易误判；统一用tonumber()或type()校验 - 集群环境下，确保所有
KEYS落在同一 slot，否则脚本根本不会执行
最常被忽略的是：脚本里调用 redis.call() 报错（比如 key 类型不匹配），会导致整个脚本中断并抛出异常，而不是静默失败。
