如何在 Docker 容器化 Go 应用中正确连接同网络下的 Redis 服务-Golang

本文详解如何让 docker 包装的 go 程序通过默认端口（6379）可靠连接同一 docker 网络中的官方 redis 容器，涵盖网络配置、连接地址写法、常见误区及验证方法。

在现代容器化开发中，Go 应用与 Redis 的协同部署十分常见。但许多开发者会遇到一个典型问题：本地 redis-cli 能成功连接 Redis 容器，而 Go 应用却报“connection refused”或“no route to host”——这通常并非代码或 Redis 配置错误，而是容器间网络通信配置不当所致。

✅ 正确做法：使用用户自定义桥接网络（推荐）

Docker 已弃用 –link（自 Docker 1.10+ 起标记为 legacy），其 DNS 解析行为受限且不支持跨网络通信。应改用 用户定义的桥接网络（user-defined bridge network），它自动提供容器名作为可解析的 DNS 主机名：

# 1. 创建专用网络
docker network create app-network

# 2. 启动 Redis 容器并加入该网络（无需暴露端口给宿主机）
docker run -d \
  --name redis \
  --network app-network \
  -e REDIS_PASSWORD="" \
  redis:7-alpine

# 3. 启动 Go 应用容器，同样加入同一网络
docker run -d \
  --name go-app \
  --network app-network \
  -e REDIS_URL="redis://redis:6379" \
  your-go-app-image

此时，在 Go 程序中，只需将 Redis 连接地址设为 redis://redis:6379（注意：redis 是容器名，非 localhost 或 127.0.0.1）：

package main

import (
    "context"
    "log"
    "time"
    "github.com/go-redis/redis/v8"
)

var rdb *redis.Client

func initRedis() {
    rdb = redis.NewClient(&redis.Options{
        Addr:     "redis:6379", // ✅ 关键：使用容器名 + 默认端口
        Password: "",           // 根据实际设置密码
        DB:       0,
    })

    ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
    defer cancel()

    if err := rdb.Ping(ctx).Err(); err != nil {
        log.Fatalf("Failed to connect to Redis: %v", err)
    }
    log.Println("✅ Connected to Redis successfully")
}

⚠️ 常见错误与注意事项

• ❌ 错误写法：redis://localhost:6379 或 redis://127.0.0.1:6379
  → 在容器内，localhost 指向自身，而非 Redis 容器。

• ❌ 避免使用 –link：该参数已过时，不支持用户定义网络，DNS 解析不可靠，且无法实现多容器服务发现。