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 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响应数据类型与预期不符。
解决方案：
为了解决以上问题，需要进行以下修改：
-
使用
ArrayList替换Collections.singletonList： 使用可变列表ArrayList确保Lua脚本正确接收KEYS参数。 -
推荐使用
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 redisScript = new DefaultRedisScript<>(script);
redisScript.setResultType(Long.class);
List keys = new ArrayList<>();
keys.add("a");
Long result = stringRedisTemplate.execute(redisScript, keys, "b");
System.out.println(result);
通过以上修改，可以有效解决返回值类型不匹配和 IllegalStateException 异常，确保Redis分布式锁的释放功能正常运行。 记住要正确处理 result 值，判断锁是否成功释放。
