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