Golang搭建Redis环境教程

Go 无法内置 Redis 服务，必须先独立启动 redis-server（如 brew install redis 后 redis-server），再用 github.com/redis/go-redis/v9 客户端连接，默认地址 localhost:6379，所有操作需传 context。

Go 本身不提供 Redis 服务，所谓“在 Golang 中搭建 Redis 环境”实际是两件事：运行 Redis 服务（独立进程），再用 Go 客户端连接它。直接编译或 go run 不会自动拉起 Redis。

Redis 服务必须单独安装和启动

Go 程序只是客户端，不能替代 Redis Server。你得先让 redis-server 在本地或远程运行起来：

• macOS：用 brew install redis，然后 redis-server 启动（默认监听 localhost:6379）
• Linux：下载官方 tar.gz 或用包管理器（如 sudo apt install redis-server），确认服务已启用：systemctl status redis
• Docker 最快验证：docker run -d --name redis-dev -p 6379:6379 redis:7-alpine
• 启动后务必测试连通性：redis-cli ping 应返回 PONG

Go 项目中引入 Redis 客户端库

主流选择是 github.com/redis/go-redis/v9（官方维护，v9 是当前稳定版）。别用已归档的 github.com/go-redis/redis（v8 及更早）。

• 初始化 client 示例：

  import "github.com/redis/go-redis/v9"
  
  rdb := redis.NewClient(&redis.Options{
      Addr:     "localhost:6379",
      Password: "", // 没设密码就空
      DB:       0,  // 默认数据库
  })
  
  ctx := context.Background()
  _, err := rdb.Ping(ctx).Result()
  if err != nil {
      log.Fatal(err)
  }

• Addr 必须显式指定，不会自动 fallback 到 localhost；DB 字段不是字符串，是整数
• 所有操作都需传入 context.Context，超时控制靠它，不是靠 client 配置

常见连接失败原因和排查点

报错 connection refused 或 timeout 时，90% 不是 Go 代码问题：

• 检查 redis-server 进程是否真在运行：ps aux | grep redis 或 docker ps
• 确认 Go 连接地址与 Redis 实际监听地址一致：Docker 容器内访问宿主用 host.docker.internal:6379（Mac/Win），Linux 用 172.17.0.1
• 防火墙或 SELinux 可能拦截 6379 端口（尤其云服务器），临时关掉试试：sudo ufw disable
• Redis 配置文件 redis.conf 中 bind 默认是 127.0.0.1，远程连接需改为 0.0.0.0 并设 protected-mode no（仅测试环境）

真正容易卡住的地方，是混淆了「服务端部署」和「客户端集成」——Go 代码里写再多 rdb.Set()，只要 redis-server 没跑起来，就全是 connection refused。先确保 redis-cli -h x.x.x.x -p 6379 ping 能通，再调 Go。