clusterclient的poolsize必须显式设置，否则默认为0并回退至硬编码值10，远低于高并发需求；应按qps×p95延迟×分片数×1.5计算，如5000 qps、2ms延迟、6节点则设100，并同步校验各节点maxclients及配置connmaxidletime和connmaxlifetime。
redis/v9 ClusterClient 的 PoolSize 必须显式设，别信默认值
go-redis/v9 对 Redis 集群的连接池管理不沿用单节点的 PoolSize 字段，而是通过 ClusterOptions.PoolSize 控制——但这个字段**不会自动继承或推导**，不设就是 0，实际运行时会 fallback 到内部硬编码的 10（v9.0.2 起），远不够高并发场景。你看到 redis: connection pool timeout 错误，八成是这里卡住的。
-
ClusterOptions.PoolSize是每个集群节点（不是整个集群）的连接池上限，比如你有 6 个分片节点，PoolSize=20意味着最多可能打开 120 个 TCP 连接 - 计算建议值：QPS × 单次操作 P95 延迟（秒）× 分片数 × 1.5 安全余量；例如 QPS=5000、延迟=2ms、6 节点 → 5000×0.002×6×1.5 ≈ 90，设
PoolSize: 100 - 必须同步检查 Redis 集群各节点的
CONFIG GET maxclients，确保单节点maxclients>PoolSize+ 订阅连接数（订阅独占连接，不进池）
ConnMaxIdleTime 和 ConnMaxLifetime 不设，集群连接早晚静默断连
Redis 集群节点通常部署在 Kubernetes 或云环境里，中间经过 NAT、SLB、iptables 等网络设备，默认 30 分钟空闲超时很容易被掐断。而 go-redis/v9 的 ClusterClient 默认 ConnMaxIdleTime = 30m、ConnMaxLifetime = 0，旧连接留在池里却已失效，后续请求直接卡死或报 i/o timeout，日志里还找不到明确错误源。
-
ConnMaxIdleTime应设为略小于服务端tcp-keepalive值（查CONFIG GET tcp-keepalive），常见设90 * time.Second或3 * time.Minute -
ConnMaxLifetime建议设30 * time.Minute，强制连接定期轮换，避免长连接状态漂移 - 这两个参数要写在
ClusterOptions里，不是Options——单节点配置不生效于集群模式
RouteRandomly=true 不能代替负载均衡，得配健康检查
RouteRandomly: true 只是让每次命令随机选一个节点发，不感知节点负载、延迟或是否宕机。一旦某个分片节点响应变慢或假死，大量请求会持续打过去，拖垮整个集群吞吐。这不是连接池问题，但会放大连接池配置不当的后果。
- 启用
OnConnect回调做节点握手验证：连接建立后立即发PING，失败则跳过该节点 - 配合
MinIdleConns（注意：这是ClusterOptions下的字段，非单节点）设为PoolSize的 40%~60%，避免冷启动时所有请求挤在少数节点上建连 - 别依赖
TestOnBorrow——v9 已移除该机制；改用ReadTimeout/WriteTimeout控制单次操作，再结合context.WithTimeout包裹整个命令调用
Redis 7.0+ 集群必须用 go-redis/v9，且版本号不能错
报错 got 4 elements in cluster info address, expected 2 or 3 是典型版本 mismatch：Redis 7.0 的 CLUSTER NODES 输出格式变了，v8 客户端解析失败。这不是连接池配置问题，但会阻断连接池初始化，导致后续所有配置都白搭。
- 确认导入路径是
github.com/redis/go-redis/v9，不是github.com/go-redis/redis/v8或带/v9但没加go-redis前缀的旧 alias - v9 的
NewClusterClient返回的是*redis.ClusterClient，不是*redis.Client，类型不兼容会导致编译失败或 panic - 如果项目同时用了 redigo 或其他 Redis 库，注意
net.Conn接口冲突风险，v9 内部已不兼容 redigo 的连接复用逻辑
集群连接池真正的难点不在参数数字，而在它把“单点连接池”那套逻辑拆成了多层：节点级池、命令路由策略、连接生命周期、服务端配置联动。漏掉任意一层，都可能让流量在某处无声堆积。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
