Redis Hash 怎样只更新一个字段而不覆盖其它字段

如果一个 Hash 里已经有 name、role 和 login_count，只想改用户名，就不要先读出整个对象再用字符串命令覆盖。直接执行 HSET user:42 name "小林" 即可：Redis 只更新指定 field，Hash 中其它 field 仍然保留。

HSET 为什么不会覆盖 Hash 的其它字段

Redis Hash 是一个 field/value 集合，命令的 key 只定位这个集合，后面的 field 决定要修改哪一项。下面的写法只改 name，role 和 login_count 不会被删除：

# 先准备一个包含多个字段的用户 Hash
redis-cli HSET user:42 name "小周" role "editor" login_count 7

# 只更新 name；未出现在命令中的 role 和 login_count 保持原值
redis-cli HSET user:42 name "小林"

# 分别读取目标字段和其它字段，确认字段级写入的范围
redis-cli HGET user:42 name
redis-cli HMGET user:42 role login_count

第一次给已存在的 field 写入时，HSET 返回新增 field 的数量为 0；如果 field 原来不存在，返回值才会增加。这个返回值描述的是“新增了几个 field”，不是“更新是否成功”。

Redis 要更新 Hash 结构里的单个字段、不覆盖其余已存字段，直接用 HSET 命令指定对应 key 和 field 赋值就可以，不会影响这个 Hash 里其他已经存在的字段。

不要把 key 的过期时间误当成字段过期时间

常见缓存对象可以给整个 Hash 设置统一 TTL：

# 写入用户资料后，为整个 user:42 设置 30 分钟的 key TTL
redis-cli HSET user:42 name "小林" role "editor"
redis-cli EXPIRE user:42 1800

# HSET 改字段不会替换 Hash 的内容，因此不会清除这个 key TTL
redis-cli HSET user:42 role "admin"
redis-cli TTL user:42

EXPIRE user:42 1800 的含义是“整个 user:42 到期后一起删除”。Redis 官方文档说明，改变 Hash 内部 field 的 HSET 不会清掉 key 的 timeout；但重新设置新的 TTL 会刷新过期时间，所以是否刷新 TTL 要在业务代码里明确。

如果不同 field 需要不同的生命周期，Redis 8.0 的 HSETEX 可以把 field 写入和字段 TTL 放在一条命令中；也可以使用 HEXPIRE 等字段过期命令。部署在较早版本时，不要把这些命令当成通用兼容写法，应先确认服务端能力，再决定拆成多个 key。

# Redis 8.0：写入两个 field，并给它们设置 60 秒字段 TTL
# 这里的过期粒度是 field，不是整个 user:42 key
redis-cli HSETEX user:42 EX 60 FIELDS 2 login_token "t-abc" last_seen "now"

# 查询字段 TTL；命令是否可用取决于 Redis 版本
redis-cli HTTL user:42 FIELDS 2 login_token last_seen

计数和多字段更新要选对命令

如果修改目标是数字计数，不建议先 HGET、在应用内加一、再 HSET。多个客户端同时执行时，读改写可能丢失更新，直接用 HINCRBY 更合适：

# 原子地把 login_count 加 1；字段不存在时按 0 参与计算
redis-cli HINCRBY user:42 login_count 1

# 一条 HSET 同时写多个互不依赖的字段，避免分成多次网络往返
redis-cli HSET user:42 role "reviewer" department "content"

# 只允许首次写入时使用 HSETNX，已有字段不会被覆盖
redis-cli HSETNX user:42 invite_source "email"

这里的“原子”要按命令边界理解：单条 Redis 命令不会被另一个命令插入。若业务要求“只有版本号仍为某值时才更新多个字段”，就不能只靠普通 HSET；应把条件判断与写入放进事务或 Lua 脚本，并为失败分支定义清楚。

用最小读取集合复查更新结果

排查“其它字段被覆盖”时，先看应用是否把整个对象序列化后写入 String，或是否执行了 DEL、SET 等替换 key 的命令；单独的 HSET 不会删除未指定 field。再用 HGET 或 HMGET 读取必要字段，避免无目的地用 HGETALL 拉取大 Hash。

常见问题

HSET 更新已有 field 会不会改变其它 field？

不会。它只覆盖同一条命令中指定的 field/value 对，未指定 field 保持原值。

每次 HSET 都要重新 EXPIRE 吗？

不一定。已有 key TTL 时，字段级 HSET 会保留它；只有滑动过期等业务明确要求刷新 TTL 时，才再次执行 EXPIRE。

HSET 返回 0 是失败吗？

不是。对已存在 field 的覆盖通常返回 0，因为没有新增 field；要判断写入后的值，应读取目标 field 或检查命令错误。