SpringBoot Redis分布式锁Lua脚本错误及解决方案：如何排查并解决RedisTemplate返回值类型不匹配和IllegalStateException异常？

spring Boot redis分布式锁及lua脚本错误排查指南

在spring boot应用中使用redis实现分布式锁，并结合Lua脚本进行锁释放时，常常会遇到一些棘手的问题。本文通过一个实际案例，分析常见错误并提供有效的解决方案。

案例分析：

开发者尝试使用Lua脚本实现Redis分布式锁的释放，但代码运行时出现错误。代码片段如下：

public void unlock(String key, Object value) {     String script = "if (redis.call('get',KEYS[1]) == ARGV[1]) then return redis.call('del',KEYS[1]) else return 0 end ";     DefaultRedisScript<Long> redisScript = new DefaultRedisScript<>(script);     Object result = redisTemplate.execute(redisScript, Collections.singletonList(key), value); }

主要问题：

问题一：返回值类型不匹配。 redisScript 的泛型为 Long，期望返回 Long 类型，但实际返回 Object。这是因为 Collections.singletonList(key) 返回的是不可变列表，而Lua脚本需要可变列表作为 KEYS 参数。

问题二：单元测试抛出 org.springframework.data.redis.RedisSystemException: redis exception; nested exception is io.lettuce.core.RedisException: Java.lang.IllegalStateException 异常。 此异常通常表明Redis响应数据类型与预期不符。

解决方案：

为了解决以上问题，需要进行以下修改：

1. 使用 ArrayList 替换 Collections.singletonList： 使用可变列表 ArrayList 确保Lua脚本正确接收 KEYS 参数。
2. 推荐使用 StringRedisTemplate： StringRedisTemplate 更适合处理字符串类型的 key 和 value，代码更清晰易懂。 确保 redisScript 的返回类型正确设置为 Long。

修改后的代码：

stringRedisTemplate.opsForValue().set("a", "b"); String script = "if (redis.call('GET',KEYS[1]) == ARGV[1]) then return redis.call('DEL',KEYS[1]) else return 0 end "; DefaultRedisScript<Long> redisScript = new DefaultRedisScript<>(script); redisScript.setResultType(Long.class); List<String> keys = new ArrayList<>(); keys.add("a"); Long result = stringRedisTemplate.execute(redisScript, keys, "b"); System.out.println(result);

通过以上修改，可以有效解决返回值类型不匹配和 IllegalStateException 异常，确保Redis分布式锁的释放功能正常运行。 记住要正确处理 result 值，判断锁是否成功释放。