Redis分布式锁常见坑点分析

日常开发中，基于 Redis 天然支持分布式锁，大家在线上分布式项目中都使用过 Redis 锁。本文主要针对日常开发中加锁过程中某些异常场景进行讲解与分析。本文讲解示例代码都在 https://github.com/wayn111/newbee-mall-pro 项目 test 目录下 RedisLockTest 类中。
版本声明：

• Spring Boot 版本 3.0.2
  
• 演示项目地址：https://github.com/wayn111/newbee-mall-pro
  
• github地址：http://github.com/wayn111 欢迎大家关注，点个star
  

一、任务超时，锁已经过期

这个异常场景说实话发生概率很低，大部分情况下加锁时任务执行都会很快，锁还没到期，任务自己就会删除锁。除非说任务调用第三方接口不稳定导致超时、数据库查询突然变得非常慢就可能会产生这个异常场景。
那怎么处理这个异常嘞？大部分人可能都会回答添加一个定时任务，在定时任务内检测锁快过期时，进行续期操作。OK，这么做好像是可以解决这个异常，那么博主在这里给出自己的见解。
1.1 先说一个暴论：如果料想到有这类异常产生，为什么不在加锁时，就把加锁过期时间设置大一点

不管所续期还是增大加锁时长，都会导致一个问题，其他线程会迟迟获取不到锁，一直被阻塞。那结果都一样，为什么不直接增大加锁时间？

想法是好的，但是实际上，加锁时间的设置是我们主观臆断的，我们无法保证这个加锁代码的执行时间一定在我们的锁过期时间内。作为一个严谨的程序员，我们需要对我们的代码有客观认知，任务执行可能几千上亿万次都是正常，但就是那么一次它执行超时了，可能由于外部依赖、当前运行环境的异常导致。

1.2 直接不设置过期时间，任务不执行完，不释放锁

如果在加锁时就不设置过期时间的话，理论上好像是可以解决这个问题，任务不执行完，锁就不会释放。但是作为程序员，总觉得哪里怪怪的，任务不执行完，锁就不会释放！

仔细想想，我们一般在 try 中进行加锁 在 finally 进行锁释放，这个好像也没毛病哦。但是实际针对一些极端异常场景下，如果任务执行过程中，服务器宕机、程序突然被杀掉、网络断连等都可能造成这个锁释放不了，另一个任务就一直获取不到锁。

这个方案程序正常的情况下，可以满足我们的要求，但是一旦发生异常将导致锁无法释放的后果，也就是说只要我们解决这个锁在异常场景下无法释放的问题，这个方案还是OK的。博主这里直接给出方案：
在不设置过期时间的加锁操作成功时，给一个默认过期时间比如三十秒，同时启动一个定时任务，给我们的锁进行自动续期，每隔 默认过期时间 / 3 秒后执行一次续期操作，发生锁剩余时长小于 默认过期时间 / 2 就重新赋值过期时长为三十秒。这样的话，可以保证锁必须由任务执行完才能释放，当程序异常发生时，仍然能保证锁会在三十秒内释放。
1.3 设置过期时间，任务不执行完，不释放锁

这个方案本质上与方案二的解决方案相同，还是启动定时任务进行续期操作，流程这里不做多余讲述。需要注意的就是加锁指定过期时间会比较符合我们的客观认知。实际上他的底层逻辑跟方案二相同，无非就是定时任务执行间隔，锁剩余时长续期判断要根据过期时间来计算。
综合来看：方案三会最合适，符合我们的客观认知，跟我们之前对 Redis 的使用逻辑较为相近。
二、线程B加锁执行中未释放锁，线程A释放了线程B的锁

说实话我仔细思考了一下这个异常场景，发现这个异常是个伪命题，如果线程 B 正在执行时，线程 A 怎么能获取到线程B的锁！线程 A 获取不到线程 B 的锁，谈何来去释放线程 B 的锁！如果线程 A 能获取到线程 B 的锁那么这个分布式锁的代码一开始就已经错了。

这里回到这个异常场景本身，我们可以给每个线程设置请求ID，加锁成功将请求ID设置为加锁 key 的对应 value，线程释放锁时需要判断当前线程的请求ID与
加锁 key 的对应 value 是否相同，相同则可以释放锁，不相同则不允许释放。
三、线程加锁成功后继续申请加锁

这个场景主要发生在加锁代码内部调用栈过深，比如说加锁成功执行方法 a，在方法 a 内又重复申请了同一把锁，导致线程把自己锁住了，这个业界的主流叫法是叫锁的可重入性。

解决方式有两种，一是修改方法内的加锁逻辑，不要加同一把锁，修改方法 a 内的加锁 key 名称。二是针对加锁逻辑做修改，实现可重入性。
这里简单介绍如何实现可重入性，给每个线程设置请求ID，加锁成功将请求ID设置为加锁 key 的对应 value，针对同一个线程的重复加锁，判断当前线程已存在请求ID的情况下，请求ID直接与加锁 key 的对应 value 相比较，相同则直接返回加锁成功。
四、 代码实践

4.1 加锁自动续期实践

设置锁过期时间为10秒，然后该任务执行15秒，代码如下：

ps: 以下代码都可以在 https://github.com/wayn111/newbee-mall-pro 项目 test 目录下 RedisLockTest 类中找到

1. @Slf4j
2. @SpringBootTest
3. @RunWith(SpringRunner.class)
4. public class RedisLockTest {
5.     @Autowired
6.     private RedisLock redisLock;
7.     @Test
8.     @Test
9.     public void redisLockNeNewTest() {
10.         String key = "test";
11.         try {
12.             log.info("---申请加锁");
13.             if (redisLock.lock(key, 10)) {
14.                 // 模拟任务执行15秒
15.                 log.info("---加锁成功");
16.                 Thread.sleep(15000);
17.                 log.info("---执行完毕");
18.             }
19.         } catch (Exception e) {
20.             log.error(e.getMessage(), e);
21.         } finally {
22.             redisLock.unLock(key);
23.         }
24.     }
25. }

复制代码

执行如下：

可以看出就算任务执行超过过期时间也能通过自动续期让代码正常执行。
4.2 多线程下其他线程无法共同申请到同一把锁实践

启动两个线程，线程 A 先加锁， 线程 B 后枷锁

1. @Test
2. public void redisLockReleaseSelfTest() throws IOException {
3.     new Thread(() -> {
4.         String key = "test";
5.         try {
6.             log.info("---申请加锁");
7.             if (redisLock.lock(key, 10)) {
8.                 // 模拟任务执行15秒
9.                 log.info("---加锁成功");
10.                 Thread.sleep(15000);
11.                 log.info("---执行完毕");
12.             } else {
13.                 log.info("---加锁失败");
14.             }
15.         } catch (Exception e) {
16.             log.error(e.getMessage(), e);
17.         } finally {
18.             redisLock.unLock(key);
19.         }
20.     }, "thread-A").start();
21.     new Thread(() -> {
22.         String key = "test";
23.         try {
24.             Thread.sleep(100L);
25.             log.info("---申请加锁");
26.             if (redisLock.lock(key, 10)) {
27.                 // 模拟任务执行15秒
28.                 log.info("---加锁成功");
29.                 Thread.sleep(15000);
30.                 log.info("---执行完毕");
31.             } else {
32.                 log.info("---加锁失败");
33.             }
34.         } catch (Exception e) {
35.             log.error(e.getMessage(), e);
36.         } finally {
37.             redisLock.unLock(key);
38.         }
39.     }, "thread-B").start();
40.     System.in.read();
41. }

复制代码

结果如下：

可以看到，线程 A 先申请到锁，线程 B 后申请锁，结果线程 B 申请加锁失败。
4.3 锁得可重入性实践

当前线程加锁成功后，在线程执行中继续申请同一把锁，代码如下：

1. @Test
2. public void redisLockReEntryTest() {
3.     String key = "test";
4.     try {
5.         log.info("---申请加锁");
6.         if (redisLock.lock(key, 10)) {
7.             // 模拟任务执行15秒
8.             log.info("---加锁第一次成功");
9.             if (redisLock.lock(key, 10)) {
10.                 // 模拟任务执行15秒
11.                 log.info("---加锁第二次成功");
12.                 Thread.sleep(15000);
13.                 log.info("---加锁第二次执行完毕");
14.             } else {
15.                 log.info("---加锁第二次失败");
16.             }
17.             Thread.sleep(15000);
18.             log.info("---加锁第一次执行完毕");
19.         } else {
20.             log.info("---加锁第一次失败");
21.         }
22.     } catch (Exception e) {
23.         log.error(e.getMessage(), e);
24.     } finally {
25.         redisLock.unLock(key);
26.     }
27. }

复制代码

结果如下：

4.4 加锁逻辑讲解

直接贴出本文最核心 RedisLock 类全部代码：

1. @Slf4j
2. @Component
3. public class RedisLock {
4.     @Autowired
5.     public RedisTemplate redisTemplate;
6.     /**
7.      * 默认锁过期时间20秒
8.      */
9.     public static final Integer DEFAULT_TIME_OUT = 30;
10.     /**
11.      * 保存线程id-ThreadLocal
12.      */
13.     private ThreadLocal<String> stringThreadLocal = new ThreadLocal<>();
14.     /**
15.      * 保存定时任务（watch-dog）-ThreadLocal
16.      */
17.     private ThreadLocal<ExecutorService> executorServiceThreadLocal = new ThreadLocal<>();
18.     /**
19.      * 加锁，不指定过期时间
20.      *
21.      * @param key key名称
22.      * @return boolean
23.      */
24.     public boolean lock(String key) {
25.         return lock(key, null);
26.     }
28.     /**
29.      * 加锁
30.      *
31.      * @param key     key名称
32.      * @param timeout 过期时间
33.      * @return boolean
34.      */
35.     public boolean lock(String key, Integer timeout) {
36.         Integer timeoutTmp;
37.         if (timeout == null) {
38.             timeoutTmp = DEFAULT_TIME_OUT;
39.         } else {
40.             timeoutTmp = timeout;
41.         }
42.         String nanoId;
43.         if (stringThreadLocal.get() != null) {
44.             nanoId = stringThreadLocal.get();
45.         } else {
46.             nanoId = IdUtil.nanoId();
47.             stringThreadLocal.set(nanoId);
48.         }
49.         RedisScript<Long> redisScript = new DefaultRedisScript<>(buildLuaLockScript(), Long.class);
50.         Long execute = (Long) redisTemplate.execute(redisScript, Collections.singletonList(key), nanoId, timeoutTmp);
51.         boolean flag = execute != null && execute == 1;
52.         if (flag) {
53.             ScheduledExecutorService scheduledExecutorService = Executors.newSingleThreadScheduledExecutor();
54.             executorServiceThreadLocal.set(scheduledExecutorService);
55.             scheduledExecutorService.scheduleWithFixedDelay(() -> {
56.                 RedisScript<Long> renewRedisScript = new DefaultRedisScript<>(buildLuaRenewScript(), Long.class);
57.                 Long result = (Long) redisTemplate.execute(renewRedisScript, Collections.singletonList(key), nanoId, timeoutTmp);
58.                 if (result != null && result == 2) {
59.                     ThreadUtil.shutdownAndAwaitTermination(scheduledExecutorService);
60.                 }
61.             }, 0, timeoutTmp / 3, TimeUnit.SECONDS);
62.         }
63.         return flag;
64.     }
66.     /**
67.      * 释放锁
68.      *
69.      * @param key key名称
70.      * @return boolean
71.      */
72.     public boolean unLock(final String key) {
73.         String nanoId = stringThreadLocal.get();
74.         RedisScript<Long> redisScript = new DefaultRedisScript<>(buildLuaUnLockScript(), Long.class);
75.         Long execute = (Long) redisTemplate.execute(redisScript, Collections.singletonList(key), nanoId);
76.         boolean flag = execute != null && execute == 1;
77.         if (flag) {
78.             if (executorServiceThreadLocal.get() != null) {
79.                 ThreadUtil.shutdownAndAwaitTermination(executorServiceThreadLocal.get());
80.             }
81.         }
82.         return flag;
83.     }
85.     private String buildLuaLockScript() {
86.         return """
87.                 local key = KEYS[1]
88.                 local value = ARGV[1]
89.                 local time_out = ARGV[2]
90.                 local result = redis.call('get', key)
91.                 if result == value then
92.                     return 1;
93.                 end
94.                 local lock_result = redis.call('setnx', key, value)
95.                 if tonumber(lock_result) == 1 then
96.                     redis.call('expire', key, time_out)
97.                     return 1;
98.                 else
99.                     return 0;
100.                 end
101.                 """;
102.     }
104.     private String buildLuaUnLockScript() {
105.         return """
106.                 local key = KEYS[1]
107.                 local value = ARGV[1]
108.                 local result = redis.call('get', key)
109.                 if result ~= value then
110.                     return 0;
111.                 else
112.                     redis.call('del', key)
113.                 end
114.                 return 1;
115.                 """;
116.     }
118.     private String buildLuaRenewScript() {
119.         return """
120.                 local key = KEYS[1]
121.                 local value = ARGV[1]
122.                 local timeout = ARGV[2]
123.                 local result = redis.call('get', key)
124.                 if result ~= value then
125.                     return 2;
126.                 end
127.                 local ttl = redis.call('ttl', key)
128.                 if tonumber(ttl) < tonumber(timeout) / 2 then
129.                     redis.call('expire', key, timeout)
130.                     return 1;
131.                 else
132.                     return 0;
133.                 end
134.                 """;
135.     }
136. }

复制代码

加锁逻辑：这里我把加锁逻辑分解成三步展示给大家

• 加锁前：先判断当前线程是否存在请求ID，不存在则生成，存在就直接使用
  
• 加锁中：通过 lua 脚本执行原子加锁操作，
  加锁时先判断当前线程ID与加锁 key 得 value 是否相等，相等则是同一个线程的锁重入，直接返加锁成功。不相等则设置加锁 value 为请求ID以及过期时间。
  
• 加锁后：启动一个定时任务，每隔 过期时间 / 3 秒后执行一次续期操作，发现锁剩余时间不足 过期时间 / 2 秒后，通过 lua 脚本进行续期操作。
  

解锁逻辑：这里我把解锁逻辑分解成两步展示给大家

• 解锁中：通过 lua 脚本执行解锁操作，先判断加锁 key 的 value 是否与自身请求ID相同，相同则让解锁，不相同则不让解锁。
  
• 解锁后：删除定时任务。
  

五、总结

其实本文得核心逻辑有许多都是参考 Redission 客户端而写，对于这些常见得坑点，博主结合自身思考，业界知识总结并自己实现一个分布式锁得工具类。希望大家看了有所收获，对日常业务中 Redis 分布式锁的使用能有更深的理解。