Redis集群在Hyperf中不采用一致性哈希，而是基于官方slot分片机制；若需一致性哈希，须手动替换驱动为PredisCluster或RedisArray，并注意协程阻塞、超时控制与降级策略。
Hyperf里Redis集群不等于一致性哈希
Hyperf默认的
不支持一致性哈希分片；它用的是 PHPRedis 或 Predis 的原生连接池逻辑，底层走的是 Redis 官方 Cluster 模式（基于 slot 分片）或主从+哨兵，不是客户端侧的一致性哈希。如果你在 config/autoload/redis.php 里配了多个 host，但没显式启用集群客户端，Hyperf 就只会连第一个节点——扩容时直接加节点不会自动分流。
要实现平滑扩容，必须替换 Redis 客户端驱动
Hyperf 允许你自定义缓存驱动，关键在于把默认的
替换成支持一致性哈希的封装层。常用路径有两种：
用
配
+ 自定义哈希策略（需继承
实现
）
用
扩展的
类（需开启
配置），它原生支持一致性哈希和自动故障转移
注意：
要求所有节点使用相同密码（若用 ACL，得统一配置 user/pass），且不支持 pipeline 批量命令跨节点——
在这种模式下会退化为串行请求。
手动注入一致性哈希缓存驱动的实操步骤
以
为例，在
中不能直接填类名，得通过 DI 容器绑定：
Hyperf 3.1.66
本页面提供企业级 PHP 协程框架 Hyperf 3.1.66 版本的官方源码下载与完整更新日志。重点解析 v3.1.66 版本中新增的 gRPC 多客户端负载均衡支持、Pool 连接池全量刷新、Guzzle 持久化 Cookie 以及数据库 JSON 包含键查询等核心优化特性。
下载
先在
中定义多个独立连接配置（如
,
）
在
中注册自定义驱动：
需实现
，重点重写
/
，把 key 交给
自动路由
扩容时只需在
新增一个连接配置，再重启服务——
会自动感知新节点并重新哈希分布，老数据不会全失效（相比普通取模，迁移量约 1/N）。
一致性哈希在Hyperf协程环境下的坑
Hyperf 是协程模型，而
内部用的是同步阻塞 I/O。如果节点响应慢，整个协程会被卡住，拖垮并发能力。必须做两件事：
给每个底层
连接配置超时：
（秒），避免单点延迟传染
禁用
的自动重试（
），改由上层业务兜底（比如 fallback 到本地内存缓存或直查 DB）
别用
注解直接套在高并发方法上——它的锁机制是基于 Redis 的，而一致性哈希后锁可能落在不同节点，导致锁失效
真正平滑的扩容，从来不是“加机器就完事”，而是客户端路由、超时控制、降级策略、监控告警四者闭环。Hyperf 提供了替换驱动的能力，但具体怎么织这张网，得你自己一针一线缝好。
RedisDriverRedisDriverPredis\ClientPredis\Connection\Aggregate\PredisClusterPredis\Connection\Aggregate\ClusterInterfacegetSlot()phpredisRedisArrayredis.arraysRedisArrayCacheInterface::getMultiple()RedisArrayconfig/autoload/cache.phpconfig/autoload/redis.phpredis-node-1redis-node-2dependencies.php$container->set(CacheInterface::class, function ($container) {
$clients = array_map(fn($name) => $container->get(RedisFactory::class)->get($name), ['redis-node-1', 'redis-node-2']);
$array = new \RedisArray($clients, ['algorithm' => 'crc32', 'retry_interval' => 100]);
return new YourConsistentHashRedisDriver($array);
});YourConsistentHashRedisDriverHyperf\Cache\Contract\CacheInterfaceget()set()RedisArrayredis.phpRedisArrayRedisArrayRedis'timeout' => 0.1RedisArray'retry_interval' => 0@Cacheable