Redis RANDOMKEY 返回空值与抽到空字符串键有什么区别

排查 Redis 随机取键时，最容易误判的一幕是：RANDOMKEY 返回后看起来什么都没有。真正的区别不在“屏幕上有没有字符”，而在 Redis 返回的是不存在的值，还是一个长度为 0 的真实键名。

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

当前数据库为空时，RANDOMKEY 返回 nil/null；数据库里存在名称为空字符串的键时，它返回普通 bulk string，只是字符串长度为 0。客户端必须区分 nil/null 与空字符串，不能只写 key == ""。

空数据库与空字符串键不是一回事

RANDOMKEY 的作用域是当前选中的数据库。没有任何键时，Redis 没有可返回的对象，因此命令返回 nil（RESP2）或 null（RESP3）。如果数据库中有一个键名恰好是空字符串，Redis 仍然找到了一个真实键，只是这个键名的字节长度为 0。

可以把两种情况放在同一张关系图里看：命令先面对“当前数据库”，然后分别遇到“没有键”和“有一个空键名”两种状态。前者是缺少返回对象，后者是返回对象存在但内容为空。

RESP2 与 RESP3 如何保留这个区别

如果只观察普通命令行输出，nil 可能表现为空行，空字符串也可能没有可见字符，所以二者看起来相同。线协议实际上使用了不同编码。

RESP2 的典型原始表示可以写成：

数据库为空：$-1\r\n
空字符串键：$0\r\n\r\n

RESP3 为数据库为空提供了专门的 Null 类型：

数据库为空：_\r\n
空字符串键：$0\r\n\r\n

第二张图把“服务器返回”“线协议编码”和“客户端解码结果”拆开。排查客户端 bug 时，重点是确认库函数有没有把 Null 错误地归一化成空字符串。

Go 客户端不要只判断 key 是否为空

以常见的 Go Redis 客户端为例，先处理命令错误，再区分“没有返回值”和“返回了空字符串”。不同客户端对空库的错误常量名称可能略有差异，但判断原则不变：把 nil/null 映射到独立分支，把空字符串当作有效键名。

ctx := context.Background()

// RANDOMKEY 可能返回 redis.Nil，也可能返回一个长度为 0 的真实键名。
key, err := rdb.RandomKey(ctx).Result()
if err == redis.Nil {
    // 当前选中的数据库没有任何键。
    return "empty-database", nil
}
if err != nil {
    // 网络、连接或协议错误不能伪装成“没有键”。
    return "", fmt.Errorf("randomkey: %w", err)
}
if key == "" {
    // 这里表示抽到了空字符串键，而不是数据库为空。
    return "empty-key-name", nil
}

// 普通非空键名可以继续用于后续读取或抽样逻辑。
return key, nil

如果业务不允许空字符串作为键名，可以在这里单独记录指标或拒绝继续处理；但不要把它和空数据库合并，否则会让“数据库被清空”和“存在特殊键名”在监控、缓存抽样、数据修复任务中产生相同结论。

排查时还要确认当前数据库

RANDOMKEY 只看当前连接的 selected database。一个连接在逻辑库 0 为空，并不代表逻辑库 9 为空；同样，测试环境里创建空字符串键后，如果切换了数据库，也可能再次看到 nil。排查记录至少要带上当前库编号、客户端协议模式，以及客户端返回值的类型。

# 先明确本次排查使用的逻辑库，避免把不同库混在一起。
redis-cli -n 9 SELECT 9
# 查看当前库的键数量，确认 RANDOMKEY 的作用域。
redis-cli -n 9 DBSIZE
# 以空字符串作为键名写入一个可识别的值。
redis-cli -n 9 SET "" marker
# 再取随机键；这里的空白外观不能替代客户端类型判断。
redis-cli -n 9 RANDOMKEY

这里的命令是排查示例，关键不是终端是否显示空行，而是让客户端同时记录“是否为 nil/null”和“字符串长度”。当长度为 0 但值不是 nil 时，就能确认抽到的是空字符串键。

结论与常见追问

• 空数据库：没有键可返回，语义是 nil/null。
• 空字符串键：键存在，语义是长度为 0 的普通字符串。
• 工程代码：先判断错误或 nil/null，再判断字符串是否为空。

为什么 redis-cli 看起来分不出来？

因为终端展示会隐藏“没有值”和“值为空”的差异。应查看客户端的空值标志、错误常量或底层 RESP，而不是用肉眼判断输出行。

删除空字符串键后为什么又变成 nil？

删除后当前数据库重新没有可返回的键，RANDOMKEY 的语义自然回到 nil/null；这不是命令随机性导致的类型变化。