webman集成redis必须区分单节点与集群模式：单节点配host/port等字段，集群须用clusters数组填全部主节点endpoint、禁用password、database为0；连接需pconnect复用，缓存键应带前缀并加随机过期偏移。
Webman 用 Redis 缓存不是加个 setex 就完事的——连接方式错、集群配置漏、过期策略硬编码，高并发下反而容易雪崩或连不上。
Webman 的 redis.php 配置必须区分单节点和集群模式
Webman 默认走 illuminate/redis + 自研适配器，但底层真正生效的是 PHPRedis 扩展的原生能力。单节点用 Redis 类，集群必须用 RedisCluster 类，二者配置结构完全不同：
- 单节点：在
config/redis.php中配'host'、'port'、'password'、'database'即可 - 集群：必须删掉
host/port字段，改用'clusters'键，填一个数组，每个元素是完整 endpoint（如"my-cluster.xxxxx.ng.0001.use1.cache.amazonaws.com:6379"） - 云 Redis 集群（AWS ElastiCache / 阿里云集群版）不支持
AUTH命令，password字段得删掉或留空；database必须为0，否则报Cross-slot keys
连接复用必须用 pconnect，不能每次 new Redis()
Webman 是常驻进程模型，每次请求都 new Redis() + connect() 会快速耗尽 socket 资源，且 TCP 握手开销明显。正确做法是复用连接实例：
- 在
config/redis.php中启用'persistent' => true（Webman 官方适配器已支持） - 手动管理时，用
$redis->pconnect('127.0.0.1', 6379, 5)，第三个参数是超时秒数，避免长连接卡死 - 切库必须用
$redis->select(0)，不能依赖配置里的database——pconnect复用连接时，上一次 select 的 db 会残留
缓存键设计与过期时间必须带随机偏移
Webman 常用于 API 网关或实时服务，若大量缓存 key 同一时刻过期（比如统一设 3600 秒），会触发缓存雪崩，数据库瞬间被打满：
- 键名建议带业务前缀 + ID，如
"user:profile:{$uid}"，避免跨模块冲突 - 过期时间别写死：
$ttl = 3600 + random_int(0, 300)，让失效时间分散在 ±5 分钟窗口内 - 慎用
setex直接塞 JSON 字符串；高频读场景建议用hSet存哈希结构，按字段更新，减少序列化开销
集群模式下报 Couldn't map cluster keyspace 的真实原因
这个错误不是 Webman 配错了，而是客户端根本没走通 Redis Cluster 协议路径：
- 你填的 endpoint 是 AWS 控制台给的「Configuration Endpoint」？那是 proxy 地址，只适用于单节点模式，集群模式下必须填「Nodes」页里所有主节点的真实地址
- telnet 不通？检查 Webman 服务器的安全组是否放行了节点端口（非 proxy 端口），VPC 路由是否可达
- 用了阿里云 Redis 集群版？控制台显示的「连接地址」是 proxy，得进「节点信息」页手动复制每个 shard 主节点的 IP:Port
最易被忽略的一点：Webman 的 redis 配置加载时机在进程启动时，改完 config/redis.php 必须重启 php start.php restart，热重载不生效。集群节点增减、密码变更这类操作，不重启等于没改。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
