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);
}
这段代码旨在通过Lua脚本检查key是否存在且值与预期值匹配，若匹配则删除key（释放锁），否则返回0。然而，单元测试报错，错误信息包含org.springframework.data.redis.RedisSystemException: Redis exception; nested exception is io.lettuce.core.RedisException: java.lang.IllegalStateException。此外，redisTemplate.execute()方法的返回值类型与预期的Long类型不符，而是Object类型。
错误原因分析与解决方案：
错误主要源于两方面：
-
参数类型不匹配:
Collections.singletonList(key)返回List，而Lua脚本的KEYS参数期望的是字符串数组。redisTemplate在处理此参数时可能存在类型转换问题。更关键的是，value参数的类型与Lua脚本中ARGV[1]的预期类型不匹配，导致Lua脚本无法正确执行。使用StringRedisTemplate和ArrayList可以解决此问题。StringRedisTemplate确保参数类型的正确性，避免类型转换错误；ArrayList则能精确传递Lua脚本所需的key数组。 -
返回值类型处理: 尽管
redisScript的泛型指定为Long，但redisTemplate.execute()返回Object类型。这可能是底层Redis客户端的返回值处理机制导致的。通过显式设置redisScript.setResultType(Long.class)，强制将返回值转换为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);
通过使用StringRedisTemplate、ArrayList传递参数，并显式设置setResultType，即可有效解决Lua脚本执行错误和返回值类型不匹配的问题。
