Redis STRLEN 为什么不能直接作为中文字符数

Redis 里执行 STRLEN key 得到的不是“用户看见了几个字”，而是这个 String 值占用了多少字节。中文通常用 UTF-8 编码，一个汉字常见为 3 个字节，所以 STRLEN 返回 6 并不代表有 6 个中文字符。Redis 官方地址：https://redis.io/

先用三个值看懂 STRLEN 的单位

Redis String 保存的是字节序列，文本只是其中一种用法。下面的实验把 ASCII、中文和空字符串放在一起比较，重点不是记住某个固定数字，而是确认返回值的单位。

# 写入三类值：ASCII、两个中文字符，以及显式的空字符串
redis-cli SET demo:ascii "Go"
redis-cli SET demo:cn "中文"
redis-cli SET demo:empty ""

# STRLEN 返回字节长度，不是屏幕上的字符个数
redis-cli STRLEN demo:ascii
redis-cli STRLEN demo:cn
redis-cli STRLEN demo:empty

在 UTF-8 环境下，Go 占 2 个字节，中文通常占 6 个字节，但人类通常把它理解为 2 个字符；空字符串的长度为 0。这个差异也会出现在 emoji、组合字符和其他多字节文字中，不能把“一个可见符号”简单等同于一个字节。

返回 0 时，缺失键和空字符串不是同一件事

STRLEN 的 0 只能说明当前 String 值没有字节可数，不能单独证明业务字段为空。键不存在时也会得到 0；如果应用把“没有昵称”和“昵称被设置为空串”当成不同状态，就必须补一次存在性判断。

# 先分别准备一个空字符串和一个不存在的键
redis-cli SET profile:empty ""
redis-cli DEL profile:missing

# 两者的 STRLEN 都是 0，但 EXISTS 可以区分键是否存在
redis-cli STRLEN profile:empty
redis-cli STRLEN profile:missing
redis-cli EXISTS profile:empty
redis-cli EXISTS profile:missing

实际项目中可以把 STRLEN 当作快速的字节长度读取，把 EXISTS 或 GET 当作状态补充。还要注意类型边界：目标键不是 String 时，Redis 会返回类型错误；不要用一个“长度接口”去掩盖键类型不一致。

需要中文字符数时，在客户端解码后统计

中文展示、输入框提示和业务字段长度通常关心字符数，而不是 Redis 内部字节数。以 Python 为例，bytes 的 len 是字节数，解码成 str 后的 len 才是 Python 的 Unicode 码点数量。两者应分别命名，避免把结果混用。

# r.get 返回 bytes；先保留字节数，用于容量或协议限制
raw = r.get("profile:name")
if raw is None:
    # None 表示键不存在，不要把它等同于空字符串
    state = "missing"
else:
    byte_count = len(raw)
    try:
        text = raw.decode("utf-8")
    except UnicodeDecodeError:
        # 非法 UTF-8 不能静默当作中文字符继续计数
        state = "invalid-utf8"
    else:
        char_count = len(text)
        state = {"bytes": byte_count, "characters": char_count}

如果业务要求“用户感知的字数”，还要进一步明确是否按 Unicode 码点、字素簇或显示宽度计算。emoji 家族、组合音标会让这三种口径不同；Redis 本身不替你决定业务口径。

按目标选择长度口径

我更倾向于在代码变量名里直接写出 byte_count、character_count 和 missing，让错误口径在评审时就暴露出来。不要为了省一次读取，把字节长度当成字符校验结果。

常见问题

Redis STRLEN 为什么对中文看起来偏大？

因为它按 UTF-8 编码后的字节数统计，中文通常占多个字节；这是编码结果，不是 Redis 把字符重复存储。

STRLEN 返回 0 能说明键不存在吗？

不能。键不存在和 String 值为空都可能返回 0，需要用 EXISTS 或 GET 区分。

能不能在 Redis 里直接得到中文字符数？

不要把 STRLEN 当作字符计数器。通常读取后在客户端按明确的 Unicode 口径计数；若数据不是合法 UTF-8，先处理编码错误。