RedisForValueService.setIfAbsent()

一、RedisForValueService 的 setIfAbsent 核心介绍

setIfAbsent 是 Redis 字符串（Value）操作中分布式锁 / 幂等性控制 的核心方法，中文可理解为「仅当键不存在时设置值」，对应 Redis 原生命令 SET key value NX（NX = Not Exists）。

在 RedisForValueService（通常是基于 Redis 客户端封装的业务层服务类）中，这个方法的核心逻辑是：

检查指定 Redis Key 是否存在；
如果不存在 ，则设置 Key-Value 并返回 true；
如果已存在 ，则不做任何操作并返回 false。

1. 通俗理解

可以把这个方法理解为「抢车位」：

车位（Redis Key）是空的 → 你停进去（设置值），返回「成功（true）」；
车位已有车 → 你无法停车，返回「失败（false）」。

2. 典型使用场景

分布式锁：多服务实例争抢同一个 Key，只有第一个抢到的实例能执行业务（如防止重复下单、定时任务重复执行）；
幂等性保障：接口调用时，用请求唯一标识作为 Key，确保同一请求只处理一次；
初始化缓存：仅当缓存未命中时，才从数据库加载数据并写入 Redis。

3. 业务调用示例（分布式锁场景）

java 复制代码

import org.springframework.stereotype.Component;
import java.util.concurrent.TimeUnit;

@Component
public class OrderService {

    private final RedisForValueService redisForValueService;

    public OrderService(RedisForValueService redisForValueService) {
        this.redisForValueService = redisForValueService;
    }

    /**
     * 创建订单（防止重复提交）
     * @param orderId 订单唯一标识
     * @return 操作结果
     */
    public String createOrder(String orderId) {
        // 1. 定义分布式锁 Key（用订单ID保证唯一性）
        String lockKey = "order:create:" + orderId;
        // 2. 尝试获取锁（设置过期时间30秒，避免服务宕机导致锁一直存在）
        boolean lockSuccess = redisForValueService.setIfAbsent(lockKey, "locked", 30, TimeUnit.SECONDS);
        
        if (!lockSuccess) {
            // 3. 锁已存在 → 重复请求，直接返回
            return "请勿重复提交订单！";
        }

        try {
            // 4. 锁获取成功 → 执行业务逻辑（创建订单）
            System.out.println("订单创建成功，订单ID：" + orderId);
            return "订单创建成功！";
        } finally {
            // 5. 释放锁（避免死锁，必须放在finally中）
            redisForValueService.delete(lockKey);
        }
    }
}

4.关键点

必须设置过期时间 ：示例中第二个重载方法带 timeout 参数，这是生产环境的必选项。如果不设置过期时间，一旦服务在执行业务时宕机，锁 Key 会一直存在，导致后续请求无法执行（死锁）。

返回值含义 ：true：Key 不存在，设置成功（抢到锁 / 首次设置缓存）；false：Key 已存在，设置失败（锁被占用 / 缓存已存在）。

原子性保障 ：Redis 的 SET NX 命令是原子操作 （检查 Key 是否存在 + 设置值一步完成），因此 setIfAbsent 能保证多线程 / 多服务实例下的并发安全，这也是它能做分布式锁的核心原因。

二、setIfAbsent 原子性的核心原理

setIfAbsent 的原子性本质上依赖 Redis 原生命令的原子性 ------ 它对应的 SET key value NX 命令是 Redis 服务器端单指令、单线程执行的，从「检查 Key 是否存在」到「设置值」的整个过程不会被其他请求打断，这是保证原子性的底层基础。

你可以把这个过程理解为：Redis 服务器接收到 SET NX 命令后，会在一个「不可分割」的执行周期内完成所有操作，不会出现「检查时 Key 不存在，但准备设置时被其他请求抢先设置」的中间态。

三、如何确保 setIfAbsent 原子性

核心：使用 Redis 原生原子命令（避免客户端拆分操作）

错误示例（非原子）：

java 复制代码

// ❌ 错误：客户端拆分了「检查」和「设置」两步，存在并发安全问题
public boolean wrongSetIfAbsent(String key, String value) {
    // 第一步：检查Key是否存在（独立命令）
    Boolean exists = stringRedisTemplate.hasKey(key);
    if (!exists) {
        // 第二步：设置值（独立命令）
        stringRedisTemplate.opsForValue().set(key, value);
        return true;
    }
    return false;
}

问题：多线程 / 多实例下，线程 A 执行完 hasKey（返回 false）后，线程 B 也执行 hasKey（同样返回 false），最终两个线程都会执行 set，导致原子性失效。

正确示例（原子）：

java 复制代码

// 底层对应Redis命令：SET key value NX EX 30（原子设置值+30秒过期）
boolean success = redisForValueService.setIfAbsent("lock:order:1001", "locked", 30, TimeUnit.SECONDS);

原理：stringRedisTemplate.opsForValue().setIfAbsent 最终会向 Redis 发送单个 SET key value NX [EX/PX] 命令，Redis 服务器单线程执行该命令，全程无中断。

四、分布式锁的超时时间应该如何设置

基于业务耗时的「99.9% 分位值」+ 冗余 ：比如统计近 7 天创建订单的耗时，99.9% 的请求都在 5 秒内完成，那么基础超时时间就设为 5秒 + 5秒冗余 = 10秒（冗余是为了应对偶尔的网络 / 数据库波动）。
绝对不小于业务的「最小耗时」：比如你的业务最快也要 2 秒完成，就不能把超时设为 1 秒（否则正常请求也会被锁超时中断）。
超时时间是「兜底值」，不是「业务执行时间上限」：超时的目的是防止线程挂掉导致死锁，而不是限制业务执行时间 ------ 真正限制业务的应该是接口超时、数据库超时等，锁超时只是最后一道防线。