Go后端容器化后无法连接PostgreSQL实例求助

核心问题定位 #

从应用日志panic: dial tcp [::1]:5432: connect: connection refused可以明确：你的Go应用仍然在尝试连接本地localhost的PostgreSQL，没有读取Kubernetes注入的环境变量。这是导致CrashLoopBackOff的直接原因。

分步排查与解决 #

1. 修改Go应用代码，读取环境变量构建连接字符串 #

你本地的代码使用了硬编码的连接字符串，部署到K8s后必须改为从环境变量获取参数：

import (
    "database/sql"
    "fmt"
    "os"
    _ "github.com/lib/pq"
)

func main() {
    // 从环境变量读取配置
    user := os.Getenv("POSTGRES_USER")
    password := os.Getenv("POSTGRES_PASSWORD")
    host := os.Getenv("POSTGRES_HOST")
    dbName := os.Getenv("POSTGRES_DB")
    sslMode := os.Getenv("POSTGRES_SSLMODE")

    // 构建符合要求的PostgreSQL连接DSN
    dsn := fmt.Sprintf("postgres://%s:%s@%s/%s?sslmode=%s", 
        user, password, host, dbName, sslMode)
    
    db, err := sql.Open("postgres", dsn)
    if err != nil {
        panic(err)
    }
    // 主动验证连接（避免sql.Open只做语法检查不实际连接）
    if err := db.Ping(); err != nil {
        panic(err)
    }
    // 后续业务逻辑...
}

2. 验证PostgreSQL Service的路由有效性 #

你的Service配置中selector: app: bookstore，需要确保PostgreSQL Pod的labels包含app: bookstore：

• 查看Pod的labels：

  kubectl get pods -n database --show-labels
  

• 查看Service的Endpoints（确认是否关联到Pod）：

  kubectl describe service postgres -n database
  

如果Endpoints为空，说明Service的selector与Pod的labels不匹配，需要修改Service的selector或Pod的labels。

3. 确认PostgreSQL的远程连接权限 #

PostgreSQL默认可能只允许localhost连接，需要修改pg_hba.conf允许K8s集群IP段访问：

• 进入PostgreSQL Pod：

  kubectl exec -it <postgres-pod-name> -n database -- bash
  

• 编辑/var/lib/postgresql/data/pg_hba.conf，添加：

  host    bookstore     santosh      10.0.0.0/8        scram-sha-256
  

  （10.0.0.0/8是K8s集群常用的CIDR，可根据你的集群实际网段调整）
• 重启PostgreSQL Pod使配置生效。

关于环境变量命名的疑问 #

POSTGRES_*还是PG*格式没有强制要求，只要代码中读取的变量名与K8s配置的环境变量名完全一致即可。比如你代码中用os.Getenv("POSTGRES_HOST")，就对应K8s里的POSTGRES_HOST环境变量，无需修改为PGHOST。

关于curl测试的说明 #

用curl访问PostgreSQL端口返回空响应是正常的——PostgreSQL使用专有协议而非HTTP，curl发送的HTTP请求会被PostgreSQL判定为无效数据包，这也是你看到invalid length of startup packet日志的原因，无需关注。

后续操作 #

1. 重新构建Go应用镜像并推送到镜像仓库
2. 更新K8s Deployment的镜像版本
3. 查看应用Pod日志，确认连接正常：

   kubectl logs -n frontend-api <bookstore-frontend-pod-name>
   

内容的提问来源于stack exchange，提问作者santoshdts