Hyperf中Redis性能优化核心在于直接使用Redis类、合理选型哈希与集合、优化连接池及序列化配置。哈希适合对象型数据的原子操作，集合适用于去重关系型数据；误用hGetAll/sMembers、未配置JSON序列化或连接池过小是常见性能瓶颈。
Hyperf 里直接用 Redis 类调用原生命令是最高效、最可控的方式，封装层（比如 Cache 类）在多数场景下反而增加冗余判断和类型转换开销。真正影响性能的不是命令本身，而是连接池配置、序列化方式、批量操作是否合并、以及哈希/集合结构是否被误用。
Redis 哈希（Hash）操作：什么时候该用 hSet 而不是 set
哈希适合存储对象型数据，比如用户资料、商品属性；单 key 存整个数组（JSON）看似简单，但无法原子更新字段、不支持部分读取、序列化/反序列化开销大。
-
hSet和hGetAll是哈希的标准写法，但注意：hSet($key, $field, $value)的$value会被自动转成字符串 —— 如果传的是数组或对象，会变成"Array"或对象标识符，必须手动json_encode - 批量写入多个字段用
hMSet（或hSet+ 数组参数，取决于 Redis 版本），比循环调用hSet快 3–5 倍 - 避免对同一个哈希 key 频繁
hGetAll后再 PHP 里过滤字段 —— 改用hMGet($key, ['field1', 'field2'])按需取值 - 哈希字段过多（>1000）且访问稀疏时，考虑拆成多个小哈希，Redis 哈希底层是压缩列表或字典，膨胀后内存和查找效率都会下降
Redis 集合（Set）操作：sAdd/sMembers 性能陷阱
集合天然去重、无序，适合标签、权限、关系类数据，但容易因误用导致 O(n) 查询或内存暴涨。
Redis Skill - 高性能缓存管理
下载
Redis 缓存和数据结构管理技能。通过自然语言操作 Redis，支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。
-
sAdd单次最多加 100 个元素，超过建议分批；不要在一个事务里反复sAdd同一个 key —— 每次都触发去重计算，sAdd($key, ...$values)一次性传入更省 -
sMembers返回全部成员，数据量大时（>5000）极易拖慢响应，应改用sScan游标分页，配合业务逻辑做流式处理 - 用
sIsMember判断存在性比in_array(..., sMembers(...))快两个数量级，后者是 PHP 层遍历，前者是 Redis O(1) 查找 - 慎用
sInter/sUnion处理大集合（>10w 元素），它们会把所有结果加载到内存再返回；如需交集统计，优先用pfAdd+pfCount（HyperLogLog）估算
Hyperf 中高频误配：连接池与序列化设置
很多“Redis 慢”问题其实出在配置上，而非命令选型。
-
redis.php配置里'pool' => ['max_connections' => 50]看似够用，但若并发请求中大量使用pipeline或长耗时 Lua 脚本，实际连接可能被占满，表现是wait_timeout超时错误 —— 建议压测时监控hyperf:redis:pool:stats命令输出 - 默认序列化用 PHP
serialize()，体积大、兼容性差；生产环境应统一设为json序列化，在redis.php加'options' => ['serializer' => \Redis::SERIALIZER_JSON] - 多库混用时（如 db 0 存业务，db 1 存缓存），别依赖
select切换 —— Hyperf 连接池不保证连接复用时 db 一致，应显式配置多个连接池（cache、queue等命名池），并用RedisFactory获取对应实例
哈希与集合混合使用的典型模式：用户标签系统
真实业务中，哈希存用户主数据，集合存标签关系，两者结合才能兼顾查询效率和灵活性。
// 用户基本信息存哈希
$redis->hSet('user:1001', ['name' => 'Alice', 'age' => 28, 'city' => 'Shanghai']);// 标签用集合独立管理
$redis->sAdd('tags:php', 1001);
$redis->sAdd('tags:backend', 1001);
$redis->sAdd('tags:hyperf', 1001);// 查某用户所有标签：查集合
$tags = $redis->sMembers('tags:1001'); // 错！这是反模式// 正确做法：标签集合名由用户ID派生，或用哈希的 field 存标签数组（需 json_encode）
$redis->hSet('user:1001', 'tags', json_encode(['php', 'backend', 'hyperf']));混合结构的关键在于边界清晰：哈希负责「主体属性」，集合负责「多对多关系」。一旦开始用集合存「某用户的标签」，就必须接受它无法直接关联哈希字段 —— 后续查用户详情+标签，得发两条命令，这时候不如把标签放哈希里，除非你真需要集合的交并差能力。
