redis lua脚本必须守住原子性、可维护性、可观测性底线：需预加载（script load）、校验keys/argv边界、设超时、隔离调试；禁用eval直连生产，须用evalsha+fallback；严禁硬编码键名、未保护循环、忽略pcall异常；脚本应版本化管理、加注释、注册别名并纳入监控。
Redis Lua脚本在企业级开发中不是“能用就行”，而是必须守住原子性、可维护性和可观测性的底线。直接结论：不预加载、不校验 KEY/ARGV 边界、不设超时、不隔离调试环境的脚本，上线即埋雷。
为什么 EVAL 不能直接上生产？
EVAL 每次都重新解析脚本，不仅浪费 CPU，还会绕过 Redis 的脚本缓存机制，导致相同逻辑反复编译。更严重的是，它让脚本内容暴露在命令日志和慢日志里，可能泄露业务逻辑或敏感参数。
- 必须先用
SCRIPT LOAD预加载脚本，拿到 SHA1 值 - 后续全部走
EVALSHA，失败时再 fallback 到EVAL - 客户端应缓存 SHA1（比如 Spring Data Redis 的
DefaultRedisScript就自动做这事） - 注意：
SCRIPT FLUSH会清空所有缓存脚本，运维操作前必须确认影响范围
KEYS 和 ARGV 用错会触发什么错误？
最常见的报错是 (error) ERR Error running script (call to f_...): @user_script:1: ERR Operation against a key holding the wrong kind of value——其实根本不是数据类型问题，而是脚本里访问了未声明的 KEYS[2] 或越界读取 ARGV[3]。
Redis 缓存和数据结构管理技能。通过自然语言操作 Redis，支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。
-
KEYS数量必须严格等于EVAL/EVALSHA第二个参数值，且所有键名必须提前传入，不能拼接 -
ARGV里传字符串就老实用tonumber()转数字，别信“传进来就是数” - 禁止在脚本里硬编码键名，比如
redis.call('GET', 'user:1001')—— 这会导致脚本无法复用、无法被监控系统识别 - 如果确实需要动态键，用
redis.call('EXISTS', KEYS[1] .. ':ext')这种方式也行，但得确保KEYS[1]是合法前缀
脚本执行卡住怎么办？
Redis 是单线程模型，一个耗时脚本会阻塞所有其他请求。企业环境里最怕的不是报错，而是无声卡死——比如循环没退出条件、redis.call() 调用不存在的键触发异常但没 catch、或者用了 redis.pcall() 却忽略返回值里的 err 字段。
- 务必设置
lua-time-limit（默认 5 秒），超时后脚本被强制终止，Redis 返回(error) BUSY Redis is busy running a script. You can only call SCRIPT KILL or SHUTDOWN NOSAVE. - 用
redis.pcall()替代redis.call()，捕获异常并显式return错误信息，避免静默失败 - 大循环（如遍历集合）必须加计数保护，例如
for i = 1, math.min(#keys, 1000) do - 调试阶段启用
--ldb-sync-mode，但生产环境绝对禁用——它会让整个 Redis 实例停摆
怎么让 Lua 脚本能被团队协作和监控？
没人能靠记忆维护几十个散落在代码注释里的脚本。企业级实践的核心是“脚本即配置”。
- 把所有脚本存在独立文件（如
stock_deduct.lua），用 CI 流水线校验语法（lua -p script.lua）、检查redis.call调用是否合规 - 脚本开头加注释块，标明用途、输入约束（如 “KEYS[1]: stock key, ARGV[1]: quantity as string”）、预期返回值
- 关键脚本在 Redis 中注册别名（如用 Hash 存
script:stock_deduct→sha1...），避免硬编码 SHA - 监控项至少包括：
redis_script_error_rate、redis_script_duration_seconds、redis_script_evicted_count
最常被忽略的点：脚本里调用 redis.log() 默认只写到 Redis 日志，但企业日志平台通常收不到——除非你改了 loglevel 并挂载了日志采集器；而 print() 在生产环境完全静默，别指望它输出调试信息。
