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 值，判斷鎖是否成功釋放。