*Redis HASH 命令
HASH 是 Redis 中与哈希（Hash）数据结构操作相关的命令分类，用于存储和操作字段-值对的集合。
*语法
HASH 类命令包含以下常用命令：
HSET key field value [field value ...]
HGET key field
HMGET key field [field ...]
HGETALL key
HKEYS key
HVALS key
HLEN key
HEXISTS key field
HDEL key field [field ...]
HINCRBY key field increment
HINCRBYFLOAT key field increment
HSETNX key field value
HSTRLEN key field
HRANDFIELD key [count [WITHVALUES]]
HSCAN key cursor [MATCH pattern] [COUNT count]
HGETDEL key field [field ...]
HGETEX key [EX seconds | PX milliseconds | EXAT timestamp | PXAT milliseconds-timestamp | PERSIST] field [field ...]
HPEXPIRE key milliseconds [NX | XX | GT | LT] field [field ...]
HSETEX key [EX seconds | PX milliseconds | EXAT timestamp | PXAT milliseconds-timestamp] field value [field value ...]
*参数说明
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| key | String | 是 | Hash 键名 |
| field | String | 是 | 字段名 |
| value | String | 是 | 字段值 |
| increment | Integer/Float | 是 | 增量值 |
| count | Integer | 否 | 随机返回的字段数量 |
| cursor | Integer | 是 | 游标，用于 HSCAN |
| pattern | String | 否 | 匹配模式 |
*返回值
- HSET: 新添加的 field 数量（Integer）
- HGET: 字段值（String）或 Nil
- HMGET: 值数组
- HGETALL: 字段和值交替的数组
- HKEYS: 字段名数组
- HVALS: 值数组
- HLEN: 字段数量（Integer）
- HEXISTS: 1 或 0
- HDEL: 成功删除的字段数量（Integer）
- HINCRBY: 新增后的值（Integer）
- HINCRBYFLOAT: 新增后的值（String）
- HSETNX: 1 成功，0 失败
- HSTRLEN: 字段值长度（Integer）
- HRANDFIELD: 随机字段名或字段名-值对
- HSCAN: 新游标和匹配元素数组
- HGETDEL: 被删除字段的值数组
- HGETEX: 字段值数组，并可选设置/清除过期
- HPEXPIRE: 成功设置过期的字段数量（Integer）
- HSETEX: 新添加的字段数量（Integer）
*时间复杂度
- HSET / HGET / HEXISTS / HDEL: O(1) 每字段
- HGETALL / HKEYS / HVALS: O(N)，N 为字段数量
- HSCAN: O(1) 每步 + O(N) 匹配
- HGETDEL / HGETEX / HPEXPIRE / HSETEX: O(1) 每字段
*示例
*基本操作
> HSET user:1001 name "Alice" age "30" city "Beijing"
(integer) 3
> HGET user:1001 name
"Alice"
> HLEN user:1001
(integer) 3
> HGETALL user:1001
1) "name"
2) "Alice"
3) "age"
4) "30"
5) "city"
6) "Beijing"
*字段检查与删除
> HEXISTS user:1001 age
(integer) 1
> HDEL user:1001 age
(integer) 1
> HEXISTS user:1001 age
(integer) 0
*增量操作
> HINCRBY user:1001 visits 1
(integer) 1
> HINCRBYFLOAT user:1001 score 1.5
"1.5"
*带过期时间的字段操作（Redis 7.4+）
> HSETEX user:1001 EX 3600 temp "value"
(integer) 1
> HGETEX user:1001 PERSIST temp
1) "value"
> HPEXPIRE user:1001 60000 NX temp
(integer) 1
*常见错误
| 错误 | 原因 | 解决 |
|---|---|---|
| WRONGTYPE | key 已存在但不是 Hash | 确认 key 类型 |
| ERR wrong number of arguments | field 和 value 未成对 | 检查参数数量 |
| ERR value is not an integer | 非数字字段做 HINCRBY | 确认字段值为数字 |
*最佳实践
- 适合存储结构化对象（用户信息、商品属性等）
- 单个 Hash 字段数建议控制在 1000 以内，避免大 Hash 阻塞
- 使用 HSCAN 遍历大 Hash，避免 HGETALL 阻塞
- 使用 HSETNX 实现字段级别的原子条件设置
- Redis 7.4+ 的 HGETEX/HSETEX/HPEXPIRE 支持字段级过期，替代方案更灵活
*FAQ
Q1: Hash 适合存储什么数据？ A: 结构化对象，如用户资料、商品属性、配置项等。
Q2: Hash 的 field 可以嵌套吗？ A: 不能直接嵌套，value 可以是 JSON 字符串模拟嵌套。
Q3: 单个 Hash 最大能存多少字段？ A: 理论上限约 232-1，但建议控制在 1000 以内。
Q4: Hash 和 String 存储 JSON 哪个更好？ A: Hash 支持字段级操作，更灵活；String 存储 JSON 更紧凑。按需选择。
Q5: HGETEX 和 HSETEX 支持字段级过期吗？ A: 是的，Redis 7.4+ 引入字段级过期功能，可以对单个字段设置 TTL。