*Redis HLEN 命令
返回 Hash 中 field 的数量。
*语法
HLEN key
*参数说明
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| key | String | 是 | Hash 的键名 |
*返回值
| 条件 | 返回值 |
|---|---|
| key 存在且为 Hash | field 数量（Integer） |
| key 不存在 | 0 |
| key 非 Hash | WRONGTYPE 错误 |
*时间复杂度
O(1)
*
*示例
> HSET user:1001 name Alice age 30
(integer) 2
> HLEN user:1001
(integer) 2
> HLEN nonexistent
(integer) 0
*常见错误
- 对非 Hash 使用：返回 WRONGTYPE。
*最佳实践
- Hash 大小监控：HLEN O(1)，可高频监控 Hash 增长，field > 5000 时告警拆分。
- 空 Hash 判断：HLEN = 0 表示 key 不存在或 Hash 为空。
*FAQ
Q: HLEN 在大 Hash 上慢吗？ A: O(1)，不遍历 field。Redis Hash 维护 field 计数器。