基于 Redis 的分布式锁:原理剖析与 Spring Boot 实战(含看门狗续期)

一、什么是分布式锁?

在单机应用中,我们常用synchronizedReentrantLock解决多线程并发问题,但这些锁的作用域局限于单个 JVM 进程。

当系统从单体架构演进为分布式集群时,多个服务实例、多个进程会并发操作共享资源(如库存、订单),此时本地锁已无法保证数据一致性,分布式锁应运而生。

分布式锁的核心目标:

  1. 互斥性:同一时刻只有一个客户端能持有锁
  2. 防死锁:锁必须能被释放,避免客户端崩溃导致锁永久占用
  3. 解铃还须系铃人:只能由加锁者自己释放锁,防止误删他人锁
  4. 高可用:锁服务本身不能成为单点故障

二、基于 Redis 的分布式锁核心原理

Redis 因其高性能、原子操作特性,成为实现分布式锁的主流选择,核心依赖以下几个关键能力:

1. 加锁:SET key value NX EX seconds 原子指令

  • NX:仅当 key 不存在时才设置,保证互斥性
  • EX seconds:设置 key 的过期时间,避免客户端崩溃导致死锁
  • value:设置为客户端唯一 ID(如 UUID),用于后续判断锁的归属

2. 解锁:Lua 脚本原子删除

直接用DEL key解锁存在风险:若锁已过期,当前客户端可能误删其他客户端的锁。因此需要通过 Lua 脚本保证 "判断锁归属 + 删除锁" 的原子性:

复制代码
-- 只有锁属于当前客户端,才执行删除
if redis.call('get',KEYS[1]) == ARGV[1] then 
    return redis.call('del',KEYS[1]) 
else 
    return 0 
end

3. 看门狗机制:解决业务超时锁释放问题

上面的时间轴,帮助我们理解不加看门狗的时候,如果业务执行时间超过锁的过期时间,锁会被自动释放,导致并发安全问题。

看门狗机制则会在业务执行期间,周期性(通常为锁过期时间的 1/3)续期锁的过期时间,直到业务执行完成:

复制代码
时间轴(秒) →  0        5        10       15
事务A(业务):  ├──────────────────────┤ (执行完成)
锁A(分布式锁):├──续期→├──续期→├──续期→┤ (始终有效)
事务B(其他业务):        (全程拿不到锁,阻塞等待)

三、Spring Boot + Jedis 4.x 实战实现

理解了上述原理,接下来请跟我一起实现吧!

1. 环境准备:依赖引入redis.clients:jedis:4.4.3

2.Jedis 连接池配置(适配 Jedis 4.x)

复制代码
@Configuration
public class JedisPoolConfig {

    @Value("${spring.redis.host:localhost}")
    private String host;

    @Value("${spring.redis.port:6379}")
    private int port;

    @Value("${spring.redis.password:}")
    private String password;

    @Value("${spring.redis.timeout:2000}")
    private int timeout;

    @Bean
    public JedisPooled jedisPooled() {
        // 先定义 host+port
        HostAndPort hostAndPort = new HostAndPort(host, port);

        // 构建客户端配置(超时、密码)
        DefaultJedisClientConfig.Builder configBuilder = DefaultJedisClientConfig.builder()
                .connectionTimeoutMillis(timeout)
                .socketTimeoutMillis(timeout);

        if (password != null && !password.isBlank()) {
            configBuilder.password(password);
        }
        DefaultJedisClientConfig clientConfig = configBuilder.build();

        // 构建连接池配置(最大连接数、空闲连接)
        GenericObjectPoolConfig<Connection> poolConfig = new GenericObjectPoolConfig<>();
        poolConfig.setMaxTotal(20);
        poolConfig.setMaxIdle(10);
        poolConfig.setMinIdle(5);

        // Jedis 4.x 唯一正确的构造方法
        return new JedisPooled(poolConfig, hostAndPort, clientConfig);
    }
}

3. 分布式锁核心

3.1 加锁

复制代码
 // 加锁
    public RedisLock lock(String lockKey, int expireSeconds) {
        this.lockKey = lockKey;
        this.expireSeconds = expireSeconds;
        this.requestId = UUID.randomUUID().toString();
        this.isLocked = false;

        SetParams params = new SetParams();
        params.nx().ex(expireSeconds);
        String result = jedis.set(lockKey, requestId, params);
        if (!LOCK_SUCCESS.equals(result)) {
            return null;
        }

        this.isLocked = true;
        startWatchDog();
        return this;
    }

3.2 解锁

直接DEL会导致误删锁,必须先判断锁归属再删除。(用lua脚本)

复制代码
 // 解锁
    public void unlock() {
        if (!isLocked) return;
        isLocked = false;
        stopWatchDog();

        String lua = "if redis.call('get',KEYS[1]) == ARGV[1] then return redis.call('del',KEYS[1]) else return 0 end";
        jedis.eval(lua, Collections.singletonList(lockKey), Collections.singletonList(requestId));
    }



   private void stopWatchDog() {
        if (scheduler != null) scheduler.shutdown();
    }


 @Override
    public void close() {
        unlock();
    }

3.3 看门狗机制

注意在业务结束或异常时要停止续期线程,避免资源泄漏

复制代码
 // 看门狗自动续期
    private void startWatchDog() {
        scheduler = Executors.newSingleThreadScheduledExecutor();
        long delay = expireSeconds * 1000L / 3;

        scheduler.scheduleAtFixedRate(() -> {
            if (!isLocked) {
                stopWatchDog();
                return;
            }
            try {
                String currentVal = jedis.get(lockKey);
                if (requestId.equals(currentVal)) {
                    jedis.expire(lockKey, expireSeconds);
                    System.out.println("[看门狗] 续期成功: " + lockKey);
                }
            } catch (Exception e) {
                stopWatchDog();
            }
        }, delay, delay, TimeUnit.MILLISECONDS);
    }

测试结果:

并发锁测试:

同一时间只有一个线程能抢到锁,其他线程全部抢锁失败,验证了互斥性。

看门狗续期测试

执行业务时间超过锁过期时间(如锁 5 秒过期,业务执行 15 秒),可以看到看门狗周期性打印续期日志,锁不会被提前释放。

总结

redis分布式锁要保证原子性 + 过期时间 + 唯一标识 + 锁续命

1)通过SET NX EX指令实现原子加锁并设置过期时间;

2)使用Lua脚本保证解锁的原子性,防止误删;

3)引入看门狗机制自动续期,解决业务执行超时问题。

相关推荐
敲上瘾14 分钟前
Redis持久化存储机制:从RDB到AOF再到混合持久化的配置与实践
linux·数据库·redis·缓存
suaizai_5 小时前
Fastjson高危漏洞紧急修复指南
spring boot
正儿八经的少年8 小时前
布隆过滤器(解决redis缓存穿透步骤之一)
数据库·redis·缓存
gugucoding12 小时前
59. 【Java】Spring Boot 入门:第一个 Web 应用
java·开发语言·spring boot
宠友信息15 小时前
内容社区源码开发实践解析,用Spring Boot打造1:1仿小红书源码平台
java·spring boot·redis·websocket·mysql·spring·uni-app
hweiyu0016 小时前
Redis命令:GET
redis
Su米苏16 小时前
Redis高级用法
spring boot·redis
paopaokaka_luck16 小时前
基于springboot3+vue3的车间生产管理系统(Echarts图形化分析、BI报表)
java·前端·spring boot·学习·echarts
摇滚侠19 小时前
《SpringBoot 3:入门与应用实战》第 7 章 AOP 思想与实现 阅读笔记 13
java·spring boot·笔记
FYKJ_201019 小时前
springboot网上购书商城---附源码15749
java·spring boot·后端·python·spark·django·php