*Redis SCRIPT 命令

SCRIPT 是 Redis Lua 脚本管理的入口命令，提供加载、检查、清空、终止和调试脚本等功能。

*语法

SCRIPT LOAD script
SCRIPT EXISTS sha1 [sha1 ...]
SCRIPT FLUSH [ASYNC | SYNC]
SCRIPT KILL
SCRIPT DEBUG (YES | NO | SYNC)
SCRIPT HELP

*参数说明

子命令 参数 类型 必填 说明
LOAD script String 是 Lua 脚本源码
EXISTS sha1 String 是 脚本的 SHA1 摘要，支持多个
FLUSH ASYNC / SYNC Flag 否 异步或同步清空缓存，默认 SYNC
KILL 无 — — 终止当前执行的脚本
DEBUG YES / NO / SYNC Flag 是 调试模式开关
HELP 无 — — 返回帮助信息

*返回值

  • LOAD：返回 SHA1 字符串
  • EXISTS：返回 0/1 整数数组（1 表示存在）
  • FLUSH：OK
  • KILL：OK 或错误（脚本已写数据时无法终止）
  • DEBUG：OK
  • HELP：帮助文本数组

*时间复杂度

  • LOAD：O(N)，N 为脚本长度
  • EXISTS：O(N)，N 为 SHA1 数量
  • FLUSH / KILL / DEBUG：O(1) ---

*示例

*加载脚本

> SCRIPT LOAD "return redis.call('GET', KEYS[1])"
"6b1bf486c81c7fb1b5c5c7a9e8d5f5c5c5c5c5c5"

*检查脚本是否存在

> SCRIPT EXISTS "6b1bf486c81c7fb1b5c5c7a9e8d5f5c5c5c5c5c5" "badsha1"
1) (integer) 1
2) (integer) 0

*清空脚本缓存

> SCRIPT FLUSH
OK
> SCRIPT FLUSH ASYNC
OK

*终止脚本

> SCRIPT KILL
OK

*常见错误

错误 原因 解决
ERR wrong number of arguments 缺少必要参数 检查子命令语法
ERR Unknown SCRIPT subcommand 子命令拼写错误 使用 LOAD/EXISTS/FLUSH/KILL/DEBUG/HELP
ERR Sorry the script already wrote to the DB KILL 时脚本已执行写操作 只能 SHUTDOWN NOSAVE 终止

*最佳实践

  • 预加载脚本：应用启动时 SCRIPT LOAD 所有常用脚本，运行时用 EVALSHA 提升性能
  • 定期清理：开发测试环境频繁变更脚本时，SCRIPT FLUSH 清理旧缓存
  • SCRIPT KILL 慎用：只终止无写操作的脚本；有写操作的脚本只能用 SHUTDOWN NOSAVE
  • 生产环境避免频繁 SCRIPT FLUSH，会导致所有 EVALSHA 回退到 EVAL

*FAQ

Q1: SCRIPT FLUSH 会清除所有脚本吗？ A: 是。清空当前实例的 Lua 脚本缓存，所有 EVALSHA 将返回 NOSCRIPT 错误。

Q2: 脚本缓存有大小限制吗？ A: 没有硬性限制，但缓存的脚本占用内存，不用的脚本应定期清理。

Q3: SCRIPT LOAD 后脚本会永久保留吗？ A: 是的，直到执行 SCRIPT FLUSH 或实例重启。Redis 不会自动淘汰已加载的脚本。