go-redis连接失败主因是环境配置错误：Redis未运行、地址为空、密码未设或Docker用127.0.0.1；v9须用redis.NewClient+Options，显式传Addr和Password；并发读写需带超时context，避免panic；结构化数据优先用Hash；注意Close与context超时配对使用。
go-redis 连接 Redis 失败的常见原因
绝大多数连接失败不是代码写错了，而是环境或配置没对上。最常踩的坑是 redis.Dialer 被误用（老版 redigo 风格）、redis.NewClient 传了空地址、或 Redis 服务根本没在本地 127.0.0.1:6379 启动。
- 确认 Redis 进程在运行：
redis-cli ping返回PONG才算通 - 新版
go-redis/redis/v9必须用redis.NewClient+&redis.Options{Addr: "127.0.0.1:6379"}，别再套用 v8 的redis.NewFailoverClient写法 - 如果 Redis 开了密码，必须显式传
Password字段，空字符串""和未设置效果不同——未设置会跳过认证，空字符串会尝试认证并失败 - Docker 环境下别写
127.0.0.1，改用宿主机网关（如host.docker.internal）或自定义网络别名
用 Set 和 Get 安全读写字符串值
SET 和 GET 看似简单，但并发场景下容易因超时或上下文取消导致静默失败。v9 版本强制要求传 context.Context，不能直接传 context.Background() 上线用。
- 写入带过期时间：
client.Set(ctx, "user:1001", "alice", 30*time.Minute)—— 第四个参数是time.Duration，不是秒数 - 读取前务必检查错误：
val, err := client.Get(ctx, "user:1001").Result()；err == redis.Nil表示 key 不存在，不是真正出错 - 避免用
client.Get(...).Val()直接取值，它会在err != nil时 panic；始终先.Result() - 大量小 key 场景下，别反复调
Set/Get，改用client.MSet和client.MGet减少 RTT
用 HSet/HGetAll 处理结构化数据
用户信息、配置项这类字段多的数据，用 Hash 比拼 JSON 字符串更省空间、更易局部更新。但要注意 Go struct 字段 tag 和 Redis field 名不自动映射，得手动展平。
Alibabacloud Sdk Client Initialization For Golang
下载
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
- 存用户结构体：
client.HSet(ctx, "user:1001", map[string]interface{}{"name": "alice", "age": 28})—— value 必须是map[string]interface{}，不能传 struct 指针 - 取全部字段：
fields, err := client.HGetAll(ctx, "user:1001").Result()返回map[string]string，数字字段（如"age"）需手动strconv.Atoi - 只更新部分字段：用
HSet单独设某个 field，不会覆盖整个 hash；但HSet不支持设置过期时间，整个 hash 的 TTL 得靠顶层 key 控制 - 慎用
HGetAll拉大 hash：如果字段超百个，建议分批用HScan流式读，避免阻塞 Redis
Close 和 context 超时必须配对使用
很多人只记得 defer client.Close()，却忽略每次命令都该有独立 context 控制超时。连接泄漏和命令卡死往往就源于此。
立即学习“go语言免费学习笔记（深入）”；
- 初始化 client 时，推荐加
PoolSize: 10（默认是 10，但显式写出来更明确）和MinIdleConns: 2防冷启动延迟 - 每个请求应创建带超时的 context：
ctx, cancel := context.WithTimeout(r.Context(), 500*time.Millisecond)，用完立刻cancel() -
client.Close()是同步阻塞操作，应在应用退出时调用（如os.Interrupt信号处理），不要在 HTTP handler 里每请求都调 - 如果看到
read tcp 127.0.0.1:xxxx->127.0.0.1:6379: i/o timeout，八成是 context 没设超时，或 Redis 响应慢但客户端没及时放弃
Redis 不是万能胶水，高频写、大 Value、复杂查询都得掂量。go-redis 的 error 类型很细，redis.Nil、redis.TimeoutErr、redis.ConnectionClosedError 含义完全不同，别一概 log.Fatal。
