redistemplate.execute() 不解析 lua 脚本，仅安全发送脚本与参数至 redis 服务端执行；真正影响“优雅”的是脚本封装（必须用 defaultredisscript 并显式设 setresulttype）、keys/argv 严格分离、集群下 key 同槽限制及错误处理机制。
RedisTemplate.execute() 调用 Lua 脚本的核心逻辑是什么
直接结论：execute() 方法本身不解析 Lua，它只负责把脚本内容（String 或 RedisScript）和参数安全地发给 Redis 服务端执行。真正决定“是否优雅”的，是脚本封装方式、参数传递结构、以及错误时的响应处理。
常见错误现象：脚本返回 null 却没报错、Long 类型被自动转成 Integer 导致 ClassCastException、脚本中用了 redis.call("set", ...) 却在集群模式下失败。
- 必须用
DefaultRedisScript包装脚本，并显式声明setResultType()，否则 Spring 无法反序列化返回值 - 键（
keys）和参数（args）要严格分离：Lua 中通过KEYS[1]访问键，ARGV[1]访问参数，不能混用 - 集群环境下，所有
KEYS必须落在同一个哈希槽，否则抛RedisClusterException
如何正确构造 DefaultRedisScript 并设置 resultType
DefaultRedisScript 不是可选包装，而是必需中间层 —— 它让 execute() 知道该把返回值转成什么 Java 类型。漏设 resultType 是最常导致 ClassCastException 的原因。
示例场景：执行一个原子计数并返回新值的脚本：
String script = "local curr = redis.call('incr', KEYS[1]); redis.call('expire', KEYS[1], ARGV[1]); return curr;";
DefaultRedisScript<long> redisScript = new DefaultRedisScript();
redisScript.setScriptText(script);
redisScript.setResultType(Long.class); // ⚠️ 这行不能少</long>
- 如果脚本返回数组（如
return {curr, 'OK'}），resultType应设为List.class，Spring 会转成ArrayList<object></object> - 返回字符串时用
String.class；返回布尔用Boolean.class；空返回（仅执行无返回）用Void.class - 不要用泛型通配符（如
DefaultRedisScript>），类型擦除后execute()无法推断
execute() 的三种调用签名怎么选
别硬记参数顺序，看实际需要传什么：键是否动态？参数是否含二进制数据？是否需指定连接工厂？
-
execute(RedisScript<t>, List<string> keys, Object... args)</string></t>：最常用。适用于键名固定或可预知、参数全是简单类型（String/Long）的场景 -
execute(RedisScript<t>, RedisConnection connection, List<string> keys, Object... args)</string></t>：需复用连接或手动控制事务时用。例如在@Transactional方法里避免新开连接 -
execute(RedisScript<t>, RedisSerializer> keySerializer, RedisSerializer> valueSerializer, List<string> keys, Object... args)</string></t>：当键或参数含中文、特殊字符、或自定义对象（需序列化）时才需要。多数情况用默认序列化器即可
注意：args 中的 null 会被转成 Redis 的 nil，但部分 Lua 命令（如 redis.call("get", ARGV[1])）对 nil 敏感，建议提前校验。
集群模式下调用 Lua 脚本的隐藏限制
Redis 集群强制要求：一个 Lua 脚本内所有操作的 KEYS 必须属于同一哈希槽，否则直接拒绝执行，报错信息类似 CROSSSLOT Keys in request don't hash to the same slot。
- 不能写
redis.call("get", KEYS[1]); redis.call("set", KEYS[2], ...)，除非KEYS[1]和KEYS[2]手动加了相同哈希标签（如{user1001}:profile和{user1001}:settings） - 若业务确实需跨键操作，只能拆成多个脚本分别执行，或改用客户端分片 + 本地事务补偿
- 本地开发用单节点 Redis 测试通过，上线集群后报错 —— 这是最典型的环境差异坑，务必在集群环境预验证
脚本的“优雅”不在于多短或多炫，而在于它在不同部署拓扑下行为一致、失败时有明确归因、返回值能被 Java 层无歧义消费。这些细节比语法糖重要得多。
