必须使用 redis.Client 而非 redis.ConnClient 线程安全、带连接池与自动重连手动管理 Conn 易致连接泄露、超时堆积需配置 PoolSize、Timeout、MinIdleConns、MaxConnAge并始终传入 context 控制生命周期。Go 连接 Redis 用 redis.Client别碰 redis.Conn老项目里还能看到用 redis.Dial 或 redis.Conn 手动管理连接的写法现在必须换掉。官方 github.com/go-redis/redis/v9 的 redis.Client 是线程安全、带连接池、自动重连的默认选择手动维护 Conn 容易漏关连接、超时没处理、panic 后连接泄露。常见错误现象read tcp 127.0.0.1:6379: i/o timeout 频发或压测时大量 too many open files —— 基本都是没走 Client 连接池自己 new Conn 又不 Close。初始化只做一次client : redis.NewClient(redis.Options{Addr: localhost:6379})全局复用不要在每次操作前 client.Dial() 或 redis.Dial()Client 内部自动取/还连接显式调用 client.Close() 只需在进程退出前比如 defer client.Close() 放在 main 函数末尾设置连接池和超时不配 PoolSize 和 Timeout 就等于裸奔默认 PoolSize 10Timeout 0无限等待线上服务扛不住并发或网络抖动时请求会卡死或堆积。Redis 操作不是 CPU 密集型但阻塞在 I/O 上会拖垮整个 HTTP handler。PoolSize 建议设为 QPS × 平均响应时间秒× 1.5例如 100 QPS × 0.05s × 1.5 ≈ 8 → 实际设 16 更稳妥Timeout 必须设比如 5 * time.Second否则网络延迟突增时 goroutine 全卡住MinIdleConns 可设为 PoolSize / 2避免冷启动后首次请求慢别忽略 MaxConnAge如 30 * time.Minute防止连接长期空闲被中间设备NAT/防火墙静默断开ctx 传参不能省没有上下文控制的 Redis 调用是定时炸弹所有 client.Get()、client.Set() 等方法第一个参数都必须是 context.Context。不用 context.Background() 硬编码尤其在 HTTP handler 里要用 r.Context() —— 否则用户关浏览器、API 超时、K8s readiness probe 失败你的 Redis 请求还在后台跑着浪费连接和资源。 唱鸭 音乐创作全流程的AI自动作曲工具集 AI 辅助作词、AI 自动作曲、编曲、混音于一体