GitLab CI中Redis Cluster连接失败，求正确配置与Golang连接方案

一、GitLab CI配置修正 #

你的配置出现连接拒绝问题，核心原因是Redis Cluster初始化未完成就执行测试，且集群节点对外宣告的是容器内部IP，导致客户端无法访问。以下是修正后的完整配置：

stages:
  - quality

testing:
  stage: quality
  image: golang:1.23
  services:
    - name: grokzen/redis-cluster:latest
      alias: redis-cluster
      command: ["--cluster-advertise-ip", "redis-cluster", "--cluster-announce-port", "6379", "--cluster-announce-bus-port", "16379"]
  before_script:
    - apt-get update && apt-get install -y redis-tools
  script:
    # 等待Redis Cluster完全就绪
    - until redis-cli -h redis-cluster -p 6379 cluster info | grep -q "cluster_state:ok"; do sleep 1; done
    - go fmt $(go list ./... | grep -v /vendor/)
    - go vet $(go list ./... | grep -v /vendor/)
    - go test -race $(go list ./... | grep -v /vendor/)
  variables:
    REDIS_HOST: redis-cluster:6379
    DEBIAN_FRONTEND: noninteractive

quality:
  stage: quality
  image: golangci/golangci-lint:v1.63.4
  script:
    - golangci-lint --version
    - golangci-lint run

关键调整说明：

• 给Redis Cluster服务添加--cluster-advertise-ip参数，强制节点对外宣告GitLab CI服务别名redis-cluster，而非容器内部IP，确保Golang客户端能正确解析节点地址。
• 增加等待脚本，通过redis-cli轮询集群状态，直到cluster_state:ok再执行测试，避免集群未就绪导致的连接失败。
• 在before_script中安装redis-tools，提供检查集群状态所需的redis-cli工具。

二、Golang连接Redis Cluster的代码优化 #

你的基础代码逻辑可行，可增加错误检查和连接测试提升稳定性：

import (
	"context"
	"fmt"
	"os"
	"strings"

	"github.com/go-redis/redis/v8"
)

func initRedisCluster() (*redis.ClusterClient, error) {
	redisAddrs := os.Getenv("REDIS_HOST")
	if redisAddrs == "" {
		return nil, fmt.Errorf("REDIS_HOST环境变量未设置")
	}

	addrs := strings.Split(redisAddrs, ",")
	rdb := redis.NewClusterClient(&redis.ClusterOptions{
		Addrs: addrs,
		// 如果集群设置了密码，取消下面注释并配置对应环境变量
		// Password: os.Getenv("REDIS_PASSWORD"),
	})

	// 测试集群连接有效性
	ctx := context.Background()
	if err := rdb.Ping(ctx).Err(); err != nil {
		return nil, fmt.Errorf("连接Redis Cluster失败: %w", err)
	}

	return rdb, nil
}

优化点说明：

• 增加环境变量非空校验，提前捕获配置缺失问题。
• 添加Ping测试，确认客户端成功连接到集群，避免后续业务操作报错。
• 保留密码配置注释，方便后续扩展认证逻辑。

内容的提问来源于stack exchange，提问作者Марк