首页 > 文章列表 > Spring Boot Redis分布式锁:Lua脚本执行错误如何解决?

Spring Boot Redis分布式锁:Lua脚本执行错误如何解决?

215 2025-03-15

Spring Boot Redis分布式锁:Lua脚本执行错误如何解决?

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类型。

错误原因分析与解决方案:

错误主要源于两方面:

  1. 参数类型不匹配: Collections.singletonList(key) 返回List,而Lua脚本的KEYS参数期望的是字符串数组。redisTemplate在处理此参数时可能存在类型转换问题。更关键的是,value参数的类型与Lua脚本中ARGV[1]的预期类型不匹配,导致Lua脚本无法正确执行。使用StringRedisTemplateArrayList可以解决此问题。StringRedisTemplate确保参数类型的正确性,避免类型转换错误;ArrayList则能精确传递Lua脚本所需的key数组。

  2. 返回值类型处理: 尽管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);

通过使用StringRedisTemplateArrayList传递参数,并显式设置setResultType,即可有效解决Lua脚本执行错误和返回值类型不匹配的问题。

来源:1740831562