Hyperf配置多个Redis实例需严格匹配redis.php键名、$poolName值及DI注册三者，否则静默降级至default；推荐用RedisFactory::get()显式获取实例，并合理设置wait_timeout、min/max_connections与heartbeat参数。
Hyperf 里配多个 Redis 实例不是加几行配置就能直接切的，得对上 poolName、redis.php 键名、DI 容器注册三者，缺一不可；否则会静默 fallback 到 default，查日志都看不出错在哪。
redis.php 里定义新连接池时，键名必须和代码里 $poolName 严格一致
比如你要新增一个叫 notify 的 Redis 实例专用于发通知，就得在 config/autoload/redis.php 里写：
'notify' => [
'host' => env('REDIS_NOTIFY_HOST', '127.0.0.1'),
'port' => (int)env('REDIS_NOTIFY_PORT', 6379),
'db' => 3,
'pool' => [
'min_connections' => 2,
'max_connections' => 15,
'wait_timeout' => 2.0,
],
],然后新建一个类，protected $poolName 必须填 notify，不能是 Notify、NOTIFY 或带空格的字符串：
Redis Skill - 高性能缓存管理
下载
Redis 缓存和数据结构管理技能。通过自然语言操作 Redis，支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。
- ✅ 正确：
protected $poolName = 'notify'; - ❌ 错误：
protected $poolName = 'Notify';（大小写敏感） - ❌ 错误：
protected $poolName = ' notify ';（前后空格导致匹配失败） - ❌ 错误：
protected $poolName = 'notification';（键名不一致，自动降级用default）
用 RedisFactory 手动取实例比继承 Redis 类更可控
继承 Redis 类的方式依赖 DI 容器自动绑定，一旦命名冲突或未注册，就拿不到预期实例。而用 RedisFactory 可以显式指定池名，调试时也更容易定位问题：
- 注入
RedisFactory：#[Inject] protected RedisFactory $redisFactory; - 按需获取：
$redis = $this->redisFactory->get('cache');或$this->redisFactory->get('queue'); - 它返回的是标准
Redis实例，所有方法（set、hGetAll、eval）都能用，无需额外封装 - 注意：如果传入的池名不存在，
get()会抛出InvalidArgumentException，而不是静默 fallback —— 这反而利于早期发现问题
wait_timeout 设太小会导致高并发下频繁报 “No available connection”
这个参数控制从连接池里取连接的最长等待时间，默认是 3.0 秒。但如果你的业务有短时流量尖峰（比如秒杀预热），又没调大 max_connections，就容易触发超时：
- 现象：
Hyperf\Pool\Exception\WaitTimeoutException: Wait timeout. - 排查点：先看
max_connections是否被压满（可用redis-cli -p 6379 info clients | grep connected_clients对比） - 调优建议：
wait_timeout不宜低于1.0，否则请求还没进池就失败；也不宜高于5.0，否则用户感知明显卡顿 - 真正关键的是
min_connections和max_connections的配比 ——min_connections应 ≥ 常驻协程数，max_connections要根据 QPS × 平均耗时 × 安全系数（建议 1.5～2.0）估算
最易被忽略的一点：Hyperf 的 Redis 连接池默认不开启心跳（heartbeat => -1），如果 Redis 服务端设置了 timeout 60，而客户端空闲连接又没主动断开，就会出现“连接已断但池子还挂着”的假活跃状态 —— 建议生产环境统一设 heartbeat => 30，让池子每 30 秒探活一次。
