Redis Script Flush 命令：让脚本缓存重置的实用指南
在日常开发中，Redis 不仅是一个高性能的内存数据库，还支持 Lua 脚本的执行，这使得复杂业务逻辑可以在服务端原子性地运行。然而，随着脚本数量的增加，尤其是动态生成或频繁更新的脚本，缓存管理就变得尤为重要。这时候，Redis Script Flush 命令就派上了用场——它能清空 Redis 中所有已加载的 Lua 脚本缓存，帮助我们解决脚本污染、内存占用过高或脚本逻辑错误的问题。
想象一下，你正在维护一个高并发的订单系统，每天有上千条脚本被动态注入到 Redis 中用于处理库存扣减、优惠券校验等操作。如果这些脚本没有及时清理，Redis 的脚本缓存区就像一个不断堆积垃圾的回收站，迟早会拖垮性能。这时候，Redis Script Flush 就像是一个“一键清空”按钮，让你快速重置脚本环境，保障系统稳定。
什么是 Redis Script Flush 命令？
Redis Script Flush 命令用于清空 Redis 实例中所有已缓存的 Lua 脚本。这些脚本通常通过 SCRIPT LOAD 命令或直接使用 EVAL 执行时被 Redis 缓存，以提升后续执行效率。
📌 注意：该命令只清除缓存，不会删除脚本本身（如果脚本是通过文件加载的，那文件仍然存在）。它作用的是 Redis 内部的脚本缓存区。
命令语法
SCRIPT FLUSH
这个命令不需要任何参数，执行后会立即清空所有已缓存的 Lua 脚本。
为什么需要它？
- 调试需求：当你在开发阶段频繁修改脚本逻辑，但发现 Redis 仍执行旧版本脚本，可能是缓存未刷新。
- 内存优化：大量脚本缓存会占用内存，尤其在容器化部署中，资源敏感时需定期清理。
- 环境重置：测试环境或 CI/CD 流水线中，确保每次测试前脚本状态干净。
实际使用场景：脚本缓存污染的排查与修复
假设你正在开发一个用户签到功能，使用 Lua 脚本判断是否可以签到。以下是你的脚本内容：
-- 文件：check_sign.lua
local today = redis.call("GET", KEYS[1])
if today then
return 0 -- 已签到，不能重复签到
else
redis.call("SET", KEYS[1], "1", "EX", 86400) -- 设置过期时间 24 小时
return 1 -- 可签到
end
你将这个脚本通过 SCRIPT LOAD 加载到 Redis：
SCRIPT LOAD "local today = redis.call('GET', KEYS[1])\nif today then\n return 0\nelse\n redis.call('SET', KEYS[1], '1', 'EX', 86400)\n return 1\nend"
Redis 返回一个 SHA1 校验和，比如：a1b2c3d4e5f6...，表示脚本已缓存。
但当你更新脚本后，再次执行 EVALSHA，却发现还是旧逻辑生效。这时你就会怀疑：是不是 Redis 还在用老脚本？
问题就出在脚本缓存。虽然你更新了脚本内容，但 Redis 仍保留着旧版本的缓存。此时，SCRIPT FLUSH 命令就能解决这个“缓存幻觉”。
如何验证脚本是否被缓存？
你可以使用 SCRIPT LIST 命令查看当前缓存的脚本列表：
SCRIPT LIST
输出示例：
1) 1) "a1b2c3d4e5f678901234567890abcdef12345678"
2) "local today = redis.call('GET', KEYS[1])\nif today then\n return 0\nelse\n redis.call('SET', KEYS[1], '1', 'EX', 86400)\n return 1\nend"
如果发现你已经更新了脚本，但缓存中仍存在旧版本，那就该执行 SCRIPT FLUSH 了。
使用 Redis Script Flush 命令的完整流程
下面是一个完整的操作流程，帮助你理解如何在开发中合理使用该命令。
步骤 1：加载脚本
SCRIPT LOAD "local today = redis.call('GET', KEYS[1])\nif today then\n return 0\nelse\n redis.call('SET', KEYS[1], '1', 'EX', 86400)\n return 1\nend"
返回：a1b2c3d4e5f678901234567890abcdef12345678
步骤 2：执行脚本（使用 SHA）
EVALSHA a1b2c3d4e5f678901234567890abcdef12345678 1 user:sign:20250405
返回：1（表示可以签到）
步骤 3：更新脚本逻辑
修改脚本，增加签到积分奖励逻辑：
-- 新脚本内容
local today = redis.call("GET", KEYS[1])
if today then
return 0 -- 已签到
else
redis.call("SET", KEYS[1], "1", "EX", 86400)
redis.call("INCRBY", KEYS[2], 10) -- 增加 10 积分
return 1
end
步骤 4：重新加载脚本
SCRIPT LOAD "local today = redis.call('GET', KEYS[1])\nif today then\n return 0\nelse\n redis.call('SET', KEYS[1], '1', 'EX', 86400)\n redis.call('INCRBY', KEYS[2], 10)\n return 1\nend"
返回新的 SHA：b2c3d4e5f678901234567890abcdef12345678
步骤 5：执行新脚本
EVALSHA b2c3d4e5f678901234567890abcdef12345678 2 user:sign:20250405 user:points:12345
返回：1，积分也正常增加，说明新脚本生效。
步骤 6：发现执行旧脚本？清空缓存！
如果发现返回值不对，或积分没有增加，说明 Redis 仍在使用旧脚本。此时执行：
SCRIPT FLUSH
✅ 执行后，Redis 会立即清空所有缓存脚本。
再次执行 EVALSHA，Redis 会提示 NOSCRIPT 错误，因为脚本不再缓存。这时你需要重新 LOAD 新脚本并再次执行。
常见误区与注意事项
误区 1：SCRIPT FLUSH 会删除 Redis 中的键值数据
❌ 错误理解：以为清空脚本缓存会影响数据。
✅ 正确认知：SCRIPT FLUSH 只影响 Lua 脚本缓存，不会删除任何键值对。Redis 的数据存储与脚本缓存是两个独立模块。
误区 2：可以随时执行 SCRIPT FLUSH，不影响生产环境
⚠️ 警告：在生产环境执行 SCRIPT FLUSH 会导致所有已缓存脚本失效，后续 EVALSHA 执行将全部报错 NOSCRIPT。这可能造成服务短暂中断。
🛠 建议：仅在以下场景使用：
- 开发或测试环境
- 确保脚本加载机制已重试逻辑（如自动
LOAD）- 通过运维脚本或定时任务控制执行时机
误区 3：SCRIPT FLUSH 可以替代 SCRIPT KILL
❌ 区别说明：
SCRIPT FLUSH：清空所有脚本缓存，不影响正在运行的脚本。SCRIPT KILL：用于终止正在运行的 Lua 脚本（仅限未修改数据的脚本）。
两者用途完全不同，不要混淆。
性能影响与最佳实践
性能影响分析
| 操作 | 是否影响性能 | 说明 |
|---|---|---|
SCRIPT FLUSH |
否（瞬时） | 仅操作内存缓存，执行极快 |
重新 LOAD 脚本 |
有（轻微） | 每次 LOAD 需要计算 SHA1，解析脚本 |
频繁 EVAL 无缓存 |
显著下降 | Redis 会每次解析脚本，效率降低 |
最佳实践建议
- 开发阶段：使用
SCRIPT FLUSH快速清理环境，避免脚本缓存污染。 - 测试环境：配合自动化脚本，在测试前自动执行
SCRIPT FLUSH。 - 生产环境：避免手动执行。建议通过脚本加载机制（如
SCRIPT LOAD+ 缓存管理）确保脚本一致性。 - 监控：定期检查
SCRIPT LIST输出，判断缓存数量是否异常增长。
总结：Redis Script Flush 命令的价值
Redis Script Flush 命令虽然简单，却在开发调试、环境清理和性能优化中扮演着关键角色。它像是一把“脚本清理器”，让你在面对缓存污染、逻辑不一致或调试困境时，能够快速恢复脚本环境的纯净状态。
无论是初学者还是中级开发者，掌握这个命令的使用场景和注意事项，都能显著提升你在 Redis 脚本开发中的掌控力。记住，一个干净的脚本缓存，就是稳定系统的基石。
在实际项目中，不妨为你的部署流程添加一条“脚本初始化”步骤：在服务启动或测试前自动执行 SCRIPT FLUSH，确保每一次运行都从“零”开始。这不仅减少出错概率，也让你的系统更易于维护和调试。
下一次当你发现脚本逻辑“不生效”时，别急着改代码，先试试 SCRIPT FLUSH——也许问题就在这儿。