Redis GETDEL 怎样读取后删除键

如果业务是“读出一个字符串值后就不再保留它”，Redis 的 GETDEL 就是直接答案。它把读取和删除放在一条命令里：键存在时返回原值并删除键，键不存在时返回空结果。该命令从 Redis 6.2.0 开始提供，复杂度为 O(1)。

官方地址：https://redis.io/docs/latest/commands/getdel/

它适合一次性令牌、消费后即失效的缓存值和简单的单键领取场景。不要把它误解成“任何读取后删除都能替代”的万能写法，后面还要看值类型、条件判断和是否涉及多个键。

GETDEL 到底做了什么

可以把 GETDEL 理解成一个明确的单键契约：输入一个 key，Redis 只处理字符串值；若 key 存在，返回旧值并让 key 消失；若 key 不存在，返回 nil。它不是先把 GET 的结果交给客户端，再由客户端决定是否 DEL，因此客户端不需要在两条命令之间维护这段删除逻辑。

用命令行可以先看最小写法：

# 写入一个只消费一次的字符串值
redis-cli SET login:token:42 "token-value"

# 读取旧值并同时删除这个键
redis-cli GETDEL login:token:42

# 再读一次会得到 nil，因为键已经不存在
redis-cli GET login:token:42

这里的关键不是输出长什么样，而是第二次读取拿不到同一个值。GETDEL 的命令属性是写操作和快速操作，返回的是删除前的字符串内容。

在 Go 中处理返回值和错误

Go 客户端通常把 GETDEL 封装成一个返回字符串和错误的调用。下面用常见的 go-redis 风格展示处理思路；具体导入路径和客户端版本应以项目实际依赖为准。

package main

import (
    "context"
    "errors"
    "fmt"

    "github.com/redis/go-redis/v9"
)

func consumeToken(ctx context.Context, client *redis.Client, key string) (string, bool, error) {
    // GETDEL 将读取和删除绑定在一次 Redis 命令中，避免客户端先 GET 再 DEL。
    value, err := client.GetDel(ctx, key).Result()
    if errors.Is(err, redis.Nil) {
        // 键不存在不是传输故障，调用方可按“未领取到”处理。
        return "", false, nil
    }
    if err != nil {
        // 网络、权限或 Redis 服务端错误不能伪装成业务上的空值。
        return "", false, fmt.Errorf("getdel %q: %w", key, err)
    }
    // value 是删除前的字符串内容；true 表示本次确实消费到了值。
    return value, true, nil
}

如果客户端把不存在的键映射为空字符串而不是 redis.Nil，要按该客户端的 API 约定判断；不要把空字符串本身当成“键一定不存在”。生产代码还应区分 Redis 错误与业务上的未命中。

三个容易踩到的边界

第一，GETDEL 只适用于字符串值。如果 key 实际保存的是 Hash、List 或 Set，Redis 会返回 WRONGTYPE，键不会因为这次错误调用而按预期完成消费。第二，键不存在时没有旧值可返回，业务上要把它看成“已经被其他请求消费”还是“从未写入”，需要由调用方决定。第三，GETDEL 不会替你延长或检查 TTL；如果过期时间本身是业务条件，应在写入和消费模型中单独设计。

把一次性 token 存成普通字符串时，结构关系可以概括为：客户端给出一个 key，Redis 在字符串键上完成读取并删除，返回删除前的值。这个模型不包含“值满足条件才删除”或“同时操作另一把 key”的步骤。

什么时候不要直接换成 GETDEL

如果只是单键、无条件、读到就删，GETDEL 比客户端组合 GET 和 DEL 更简洁。若要“值等于某个版本才删除”，需要条件判断；若要同时修改多个键，需要事务或 Lua 脚本把条件和动作放在更完整的原子边界内。

总结与相关问题

记住三点：GETDEL 面向字符串键；命中时返回旧值并删除；未命中、类型错误和条件删除是三种不同分支。先确认业务是否真的是“单键、无条件、一次性消费”，再决定是否采用它。

GETDEL 和 GET 后再 DEL 有什么区别？

GETDEL 把读取与删除放在一条 Redis 命令的语义里，客户端不需要在两条命令之间承担删除决策；GET 加 DEL 则保留了更大的业务控制空间，但要自己处理并发和失败边界。

键不存在时会返回什么？

没有可返回的旧值，客户端通常把它映射为空结果或特定的 nil 错误。应按客户端库约定处理，而不是把所有错误都当成未命中。