Redis重启后脚本SHA1失效是设计使然:SCRIPT LOAD仅将脚本存于内存lua_scripts字典,不写入RDB/AOF、不复制、不同步,主从切换或集群路由均导致EVALSHA报NOSCRIPT。

Redis重启后脚本SHA1失效,不是bug,是设计如此——脚本缓存只存在内存里,不落盘、不同步、不复制。
SCRIPT LOAD加载的脚本不写入RDB/AOF
Redis 6.0 和 7.0 明确规定:SCRIPT LOAD 只把脚本内容和对应 SHA1 存进内存字典 lua_scripts,不会触发持久化。这意味着:
- RDB快照生成时,这个字典被跳过,重启从RDB恢复后自然为空
- AOF重写时,
SCRIPT LOAD命令本身不记录(它不是数据变更命令),所以AOF里根本没有它的影子 - 哪怕你用
EVAL执行过脚本,它也只会临时缓存,同样不落盘
主从/哨兵/集群下脚本不自动同步
脚本缓存是实例级的,不是集群级或复制流的一部分:
- 主库上
SCRIPT LOAD的结果,不会通过 replication buffer 推给从库 - 哨兵切换后,新主库(原从库)内存干净,
EVALSHA必然返回NOSCRIPT No matching script - Redis Cluster 中,
SCRIPT LOAD只作用于当前节点;如果脚本涉及多个 key,而EVALSHA路由到没加载过的节点,照样报错
SCRIPT FLUSH 或内存淘汰也可能清空缓存
除了重启,还有几种“静默清空”方式容易被忽略:
- 运维误执行
SCRIPT FLUSH,所有 SHA1 瞬间消失 - Redis 内存紧张时,某些定制版或旧版本可能触发非标准淘汰逻辑(虽官方不承诺,但有案例)
- 云托管 Redis(如阿里云Tair、腾讯云CKV)部分版本在扩缩容或热升级时会重建实例,等效于重启
为什么不能靠第一次请求自动回退EVAL来解决?
看似可行,但生产环境里这招常翻车:
- 高并发下多个请求同时
EVALSHA失败,又同时走EVAL,造成重复SCRIPT LOAD,浪费带宽且可能触发限流 - 脚本里有
redis.call("SET", ...)这类写操作,EVAL重入可能破坏原子性(比如分布式锁被重复获取) - 某些客户端(如老版本 Jedis)对
NOSCRIPT异常捕获不完整,直接抛RedisSystemException中断流程 -
EVAL每次传完整脚本,比EVALSHA多出几KB网络开销,在千QPS以上场景会明显拖慢RT
真正要稳,得在应用启动时就对每个节点做预加载,而不是赌“第一次请求能兜住”。尤其当你的服务依赖脚本做核心路径(比如库存扣减、幂等校验),缓存是否在线,得由你控制,不能交给Redis的内存运气。


















