Spring Boot + Redission实战 -> 实现分布式锁

本文介绍了如何使用SpringBoot结合Redisson实现分布式锁来确保接口幂等性。通过自定义注解@Lock、切面LockAspect以及任务推送执行器TaskPushExecutor,确保每个任务只推送一次。在Kibana中观察日志确认分布式锁正常工作。


需求场景:执行推送任务,保证每个任务只推送一次。
处理流程:将需要幂等性的接口加上自定义注解。然后编写一个切面,在Around方法里逻辑:尝试获取分布式锁(带过期时间),成功表明没重复提交,否则就是重复提交了。
具体的redis已经配置在了nacos中,这里不做赘述。

1.添加Redission依赖

<dependency>
        <groupId>org.redisson</groupId>
        <artifactId>redisson-spring-boot-starter</artifactId>
        <version>3.11.5</version>
</dependency>

2.自定义注解类型实现分布式锁:@Lock

@Target({ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Component
public @interface Lock {

    String prefix() default "";

    String key() default "";

    long expire() default 60L;

    int tryCount() default 3;
} 

3.分布式锁切面:LockAspect

@Slf4j
@Aspect
@Order(1000)
@Component
public class LockAspect {
    public static final String TASK_PUSH_LOCK_PREFIX = "cms:";
	
    @Autowired
    private RedissonClient redissonClient;
    private static DefaultParameterNameDiscoverer discoverer = new DefaultParameterNameDiscoverer();
    private static SpelExpressionParser parser = new SpelExpressionParser();

    //增强带有Lock注解的方法
    @Pointcut("@annotation(com.xxx.cms.service.annotation.Lock)")
    public void LockAspect() {
    }

    @Around("LockAspect()")
    public Object redisLock(ProceedingJoinPoint point) throws Throwable {
        Object result;
        Class<?> clazz = point.getTarget().getClass();
        MethodSignature methodSignature = (MethodSignature) point.getSignature();
        Method method = clazz.getDeclaredMethod(methodSignature.getName(), methodSignature.getParameterTypes());
        Lock redisLockAnnotation = method.getAnnotation(Lock.class);
		// 拼接 key
        final String key = generateKeyBySpEL(redisLockAnnotation.key(), method, point.getArgs());
       
	    String prefix = StringUtils.isEmpty(redisLockAnnotation.prefix()) ? TASK_PUSH_LOCK_PREFIX + ":"+ method.getName()+":" : redisLockAnnotation.prefix();
        String lockKey = StringUtils.isEmpty(key)
                ? prefix
                : prefix + ":" + key;
        log.info("分布式锁,创建key:{}", lockKey);
        //redisson核心步骤1 getLock 获取锁
		final RLock lock = redissonClient.getLock(lockKey);
		
        try {
            lockKeyList.add(new RedisLockInfo(lockKey, redisLockAnnotation.expire(), redisLockAnnotation.tryCount(), Thread.currentThread()));
            //redisson核心步骤2 lock  加锁
     	    lock.lock(redisLockAnnotation.expire(), TimeUnit.SECONDS);
     	    //需要加锁的具体业务逻辑
            result = point.proceed();
			//redisson核心步骤3 unlock 释放锁
            lock.unlock();
            log.info("# [END]分布式锁,删除key:{}", lockKey);
            return result;
        } catch (CommonException ie) {
            log.error("分布式锁,请求超时", ie.getMessage());
            throw new Exception(ie.getMessage());
        } catch (Exception e) {
            log.error("分布式锁,创建失败", e);
			//redisson核心步骤4 unlock 最后记得释放锁
            lock.unlock();
            log.info("# [END]分布式锁,删除key:{}", lockKey);
        }
        return false;
    }

    private static String generateKeyBySpEL(String spELString, Method method, Object[] args) {
        String[] paramNames = discoverer.getParameterNames(method);
        Expression expression = parser.parseExpression(spELString);
        EvaluationContext context = new StandardEvaluationContext();
        for (int i = 0; i < args.length; i++) {
            assert paramNames != null;
            context.setVariable(paramNames[i], args[i]);
        }
        return Objects.requireNonNull(expression.getValue(context)).toString();
    }

    @Data
    class RedisLockInfo{
        private String key;
        private int tryNums;
        private int tryCount;
        private Thread thread;
        private long expireTime;

        public RedisLockInfo(String key,long expireTime,int tryCount,Thread thread){
            this.key = key;
            this.tryCount = tryCount;
            this.thread = thread;
            this.expireTime = expireTime;
        }
    }
}	

4.任务推送执行器TaskPushExecutor

@Component("taskPushExecutor")
public class TaskPushExecutor extends AbstractExecutor<UserInfo> {
    public static final String PUSH_TASK_PREFIX = "cms:push:task:scheduler:";
    //只需要在保证幂等性的接口上,加上自定义的@Lock注解就好了
	@Lock(prefix=PUSH_TASK_PREFIX,key="#task.taskSign+':'+#task.taskId+':'+#task.userGroupId",expire = 300L,tryCount = 3)
    @Override
    public void execute(ITaskHandler taskHandler, Task task) {
        //执行具体的业务逻辑
        executeTask(taskHandler, task);
    }
}

5.查询执行日志状况

可以通过Kibana查看日志,发现加锁和释放锁,均是成对出现,分布式锁正常!
在这里插入图片描述
参考文章
拜托,面试请不要再问我Redis分布式锁的实现原理
Spring Boot + Redis实战-利用自定义注解+分布式锁实现接口幂等性

### Spring BootRedisson 实现分布式锁的方式 #### 添加依赖 为了在 Spring Boot 项目中使用 Redisson 来实现分布式锁,首先需要引入 Redisson 的 Maven 或 Gradle 依赖。以下是具体的配置方法: 对于 Maven 构建工具,可以在 `pom.xml` 文件中添加如下依赖[^1]: ```xml <dependency> <groupId>org.redisson</groupId> <artifactId>redisson-spring-boot-starter</artifactId> <version>3.20.0</version> </dependency> ``` 对于 Gradle 构建工具,则可以添加以下内容到 `build.gradle` 文件中[^2]: ```gradle implementation 'org.redisson:redisson-spring-boot-starter:3.20.0' ``` #### 配置 Redisson 客户端 接下来,在项目的 `application.yml` 或 `application.properties` 文件中配置 Redisson 连接参数。例如,通过单机模式连接 Redis: ```yaml spring: redisson: config: | singleServerConfig: address: "redis://127.0.0.1:6379" database: 0 password: null ``` 如果采用集群模式或其他高级配置,可以根据实际需求调整上述设置。 #### 使用分布式锁 Redisson 提供了多种类型的锁,其中最常用的是基于 Reentrant Lock (可重入锁) 的实现。下面是一个简单的代码示例,展示了如何获取并释放分布式锁[^3]: ```java import org.redisson.api.RLock; import org.redisson.api.RedissonClient; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.stereotype.Service; @Service public class DistributedLockService { @Autowired private RedissonClient redissonClient; public void executeWithLock() { // 获取名为 "my-lock" 的分布式锁实例 RLock lock = redissonClient.getLock("my-lock"); try { // 尝试加锁,最多等待 10 秒钟,上锁以后 30 秒自动解锁 boolean isLocked = lock.tryLock(10, 30, TimeUnit.SECONDS); if (isLocked) { System.out.println("成功获得锁..."); // 执行业务逻辑... Thread.sleep(5000); // 模拟耗时操作 System.out.println("完成业务处理..."); } else { System.out.println("未能获得锁!"); } } catch (InterruptedException e) { Thread.currentThread().interrupt(); throw new RuntimeException(e); } finally { // 确保最终能够释放锁 if (lock.isHeldByCurrentThread()) { lock.unlock(); // 解锁 System.out.println("已释放锁"); } } } } ``` 此代码片段实现了对指定资源的锁定保护机制,并确保即使发生异常也能安全地解除锁定状态。 #### 可选功能——公平锁 除了普通的可重入锁外,还可以选择启用 **公平锁** ,这会按照请求顺序分配锁给线程而不是随机挑选其中一个。创建公平锁的方法如下所示: ```java RLock fairLock = redissonClient.getFairLock("fair-lock-name"); ``` --- ###
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值