SCRIPT LOAD命令仅缓存Lua脚本并返回SHA1值，不支持传参；必须用单引号包裹脚本字符串，避免shell解析错误；成功后需通过EVALSHA加SHA值调用，失败时fallback至EVAL。
SCRIPT LOAD 命令本身不支持参数传入
你不能用 SCRIPT LOAD 直接执行带参数的脚本，它只做一件事：把 Lua 脚本源码编译并缓存到 Redis 服务器内存中，返回一个 SHA1 校验值（如 "24e8f9c5a0d7b6e3f1a2c3d4e5f6a7b8c9d0e1f2"）。这个 SHA 值后续用于 EVALSHA 快速调用。
常见错误是试图这样写：SCRIPT LOAD "return ARGV[1] + ARGV[2]" 1 2 —— 这会报错 ERR wrong number of arguments for 'script' command，因为 SCRIPT LOAD 只接受一个参数：脚本字符串。
- 脚本内容必须是纯字符串，不能含未转义的双引号或换行（若用 redis-cli，建议用单引号包裹整个脚本）
- 如果脚本里用了
redis.call()或redis.pcall()，它们在SCRIPT LOAD阶段不执行，仅校验语法；出错要等到EVAL或EVALSHA时才暴露 - Redis 7.0+ 支持
FUNCTION LOAD（基于 Lua 5.4），但和SCRIPT LOAD不兼容，老脚本不能混用
用 redis-cli 正确预加载脚本的姿势
最常用、最稳妥的方式是在终端用 redis-cli 执行 SCRIPT LOAD。注意 shell 对引号和特殊字符的处理：
Redis 8.2.3
下载
Redis 8.2.3 是一款安全优先的高性能键值存储系统。该版本紧急修复了可能引发远程代码执行（RCE）的高危漏洞（CVE-2025-62507），并解决了 HyperLogLog 及 Cuckoo Filter 等数据结构在特定场景下的崩溃问题。建议所有用户立即升级，以保障生产环境的系统稳定与数据安全。
- Linux/macOS 下推荐用单引号包裹脚本，避免 shell 解析变量或转义：
redis-cli SCRIPT LOAD 'return {KEYS[1], ARGV[1]}' - 如果脚本含单引号，改用双引号 + 反斜杠转义：
redis-cli SCRIPT LOAD "return 'hello world'" - 脚本较长时，可先存为文件（如
inc.lua），再用redis-cli SCRIPT LOAD "$(cat inc.lua)"（注意确保文件无 BOM、换行符为 LF） - Windows PowerShell 中需用反引号转义引号，或改用
redis-cli -x SCRIPT LOAD < inc.lua（-x表示从 stdin 读脚本）
SCRIPT LOAD 后如何安全调用？别漏掉 EVALSHA 的 fallback
SCRIPT LOAD 返回的 SHA 值不是永久有效的：Redis 重启后所有预加载脚本丢失，集群节点间也不自动同步。所以生产环境必须实现 EVALSHA + EVAL fallback 逻辑：
- 先尝试
EVALSHA <sha> 1 key1 "val"；若返回"NOSCRIPT No matching script. Please use EVAL."，说明脚本未加载，立刻用EVAL重发完整脚本 - 客户端 SDK（如 Jedis、redis-py）通常内置该逻辑，但需确认是否启用（例如 redis-py 的
evalsha方法默认不自动 fallback，得自己 wrap） - 不要在应用启动时一次性
SCRIPT LOAD所有脚本——Redis 有script cache限制（默认 5000 个），且冷脚本长期不用会被 LRU 清除
为什么有些脚本 SCRIPT LOAD 成功但 EVALSHA 报错？检查这三点
现象：脚本明明用 SCRIPT LOAD 返回了 SHA，但 EVALSHA 却报 NOSCRIPT。大概率是以下原因：
- 连接的是不同 Redis 实例（比如连了从库，而
SCRIPT LOAD发到了主库；或集群模式下连错了节点） - 脚本内容有不可见差异：空格、换行符（CRLF vs LF）、BOM 头、中文全角标点——哪怕一个空格不同，SHA 就完全不同
- 使用了非标准 Lua 函数（如
os.time()、math.random()），虽不影响SCRIPT LOAD，但在EVALSHA执行时因沙箱限制直接失败，错误信息反而被掩盖成NOSCRIPT
调试时最简单的方法是用 SCRIPT EXISTS <sha> 确认当前连接的实例是否真有该脚本；再用 SCRIPT FLUSH 清空后重试，排除缓存干扰。
