SpringBoot Redis分布式锁Lua脚本释放异常分析及解决方案
在使用SpringBoot集成Redis实现分布式锁时，运用Lua脚本进行锁释放可能会遇到返回值类型不匹配和IllegalStateException异常。本文将通过一个案例分析问题根源并提供解决方案。
问题描述：
开发者使用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);
}
该脚本旨在检查key的值是否与传入的value匹配，若匹配则删除key（释放锁），否则返回0。运行时出现以下问题：
-
问题一：
redisTemplate.execute()返回值类型为Object，而非预期的Long。 -
问题二：单元测试执行
unlock方法时抛出org.springframework.data.redis.RedisSystemException: Redis exception; nested exception is io.lettuce.core.RedisException: java.lang.IllegalStateException异常。
错误原因及解决方案：
分析错误日志和代码，问题主要在于两点：
-
Collections.singletonList(key)类型不匹配：虽然Collections.singletonList(key)返回List，但redisTemplate在处理keys参数时存在类型转换问题。 Lua脚本期望KEYS为一个键的数组。 使用ArrayList明确指定keys参数类型可以解决此问题。 -
redisTemplate泛型类型不匹配：DefaultRedisScript期望返回Long类型，但redisTemplate可能无法直接返回Long类型。Lua脚本返回的是数值型字符串，需要进行类型转换。使用StringRedisTemplate更适合处理字符串类型的key和value，并能更直接地处理Lua脚本返回的数值型字符串。
修改后的代码：
StringRedisTemplate stringRedisTemplate; // Inject StringRedisTemplate
public void unlock(String key, String value) { // Changed Object value to String 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);
redisScript.setResultType(Long.class); // Explicitly set the result type
List keys = new ArrayList<>();
keys.add(key);
Long result = stringRedisTemplate.execute(redisScript, keys, value); // Use StringRedisTemplate
System.out.println(result);
}
通过以上修改，解决了返回值类型不匹配和IllegalStateException异常，确保Lua脚本正确执行。 关键在于使用StringRedisTemplate并显式设置redisScript的resultType为Long.class。 同时，将value参数的类型改为String，以匹配Lua脚本中的ARGV[1]。
记住在你的Spring Boot配置中注入StringRedisTemplate。 例如：
@Bean
public StringRedisTemplate stringRedisTemplate(RedisConnectionFactory redisConnectionFactory) {
StringRedisTemplate template = new StringRedisTemplate();
template.setConnectionFactory(redisConnectionFactory);
return template;
} 
