搭建Golang环境与配置Redis客户端连接测试-Golang-PHP中文网

redis服务未运行是connection refused错误的主因，需先验证redis-server状态：macos用brew services list或redis-cli ping，linux用systemctl status redis，docker检查docker ps及端口映射，远程服务器则确认bind 0.0.0.0与protected-mode no。

搭建golang环境与配置redis客户端连接测试

Go 本身不运行 Redis，必须先让 redis-server 跑起来，再用 Go 客户端连——这是绝大多数连接失败的根本原因，不是代码写错了。

确认 redis-server 已真实运行

所有 connection refused 或超时错误，90% 都卡在这一步。别急着改 Go 代码，先验证服务状态：

macOS：运行 brew services list | grep redis，或直接 redis-cli ping，返回 PONG 才算通
Linux：用 systemctl status redis 或 ps aux | grep redis-server
Docker：执行 docker ps | grep redis，并确认端口映射正确（如 -p 6379:6379）
远程服务器：检查 redis.conf 中 bind 是否仍为 127.0.0.1（需改为 0.0.0.0），且 protected-mode no（仅测试环境）

用 github.com/redis/go-redis/v9 初始化 client

v8 及更早版本已归档，github.com/redis/go-redis/v9 是当前唯一维护中的官方客户端。安装命令必须是：

go get github.com/redis/go-redis/v9

初始化时注意三点：

Addr 必须显式填写，比如 "localhost:6379"，不会 fallback 到默认值
DB 是整数（如 0），不是字符串 "0"
所有操作必须传非 nil context.Context，传 nil 会 panic 报错 context must be non-nil

示例片段：

Golang Samber Hot

在 Golang 中使用 samber/hot 进行内存缓存，支持 LRU、LFU、TinyLFU、W‑TinyLFU、S3FIFO、ARC、TwoQueue、SIEVE、FIFO 等淘汰算法，提供 TTL、缓存加载器及分片功能。

下载

import "github.com/redis/go-redis/v9"<br>rdb := redis.NewClient(&redis.Options{<br>    Addr:     "localhost:6379",<br>    Password: "",<br>    DB:       0,<br>})<br>ctx := context.Background()<br>_, err := rdb.Ping(ctx).Result()<br>if err != nil {<br>    log.Fatal(err)<br>}

Docker 容器里连宿主 Redis 的地址怎么填

如果你的 Go 程序在 Docker 容器中运行，而 Redis 在宿主机上，localhost:6379 指的是容器自己，不是你的开发机：

macOS / Windows：用 host.docker.internal:6379
Linux：通常用 172.17.0.1:6379（Docker 默认网桥网关）
如果用 Docker Compose，推荐直接写服务名，如 redis:6379，前提是网络互通且 DNS 可解析

硬写 localhost 是最常踩的坑，连不上第一反应就该查这个。

集群模式下不能只传一个节点地址

Redis 集群要求至少 3 主 3 从共 6 节点才能正常握手；Go 客户端必须用 redis.NewClusterClient，而不是 redis.NewClient：

Addrs 字段必须传至少 2–3 个可连通的 master 地址，例如 []string{"127.0.0.1:7000", "127.0.0.1:7001"}
地址不能混入从节点（除非明确配置读从），否则初始化阶段可能因从节点不响应 CLUSTER SLOTS 而超时
KEYS、SCAN 这类跨 slot 命令会被拒绝，报错类似 CROSSSLOT Keys in request don't hash to the same slot

集群连不上，八成是没启动真集群，或者 Go 侧误用了单机 client。

真正容易被忽略的，是把「服务端部署」和「客户端集成」当成一件事——redis-server 没跑，rdb.Set() 再多也白搭。