Go 调 HTTPS 接口报 TLS certificate verify failed 或 server gave HTTP response 怎么修服务端 SSL 配置

现象:Go 程序调 HTTPS 接口 TLS 握手失败

Go 程序用 http.CLIent 调后端 HTTPS 接口,突然报两类错:一类是 "x509: certificate has expired or is not yet valid",另一类是 "server gave HTTP response to HTTPS client"。curl -v 测试正常,只有 Go 报错。排查发现后端刚换了证书但没完全配好,Go 对 TLS 校验比 curl 严格得多。

根因一:证书过期或域名不匹配

Go crypto/tls 库默认严格校验证书链和域名匹配。证书过期、SAN 里没有请求的域名、中间证书没配全都会报 x509 错误。浏览器和 curl 有时宽容一些(比如自签名证书加 -k 就过),Go 不会。

// 临时调试:跳过证书校验(仅限本地,生产别用!)
client := &http.Client{
    Transport: &http.Transport{
        TLSClientConfig: &tls.Config{InsecureSkipVerify: true},
    },
}

// 正确做法:加载系统或自定义 CA
pool, _ := x509.SystemCertPool()
ok, _ := pool.AppendCertsFromPEM([]byte(caPEM))
client := &http.Client{
    Transport: &http.Transport{
        TLSClientConfig: &tls.Config{RootCAs: pool},
    },
}

根因二:服务端 SSL 配置缺失

"server gave HTTP response to HTTPS client" 说明客户端发的是 TLS ClientHello,服务端回的是明文 HTTP。大概率是 Nginx 443 端口的 SSL 配置被注释掉了,443 跑成了 HTTP。curl 用 -k 能过是因为 curl 帮你降级了协议,Go 不会。

# Nginx 正确的 SSL 配置
server {
    listen 443 ssl;
    server_name api.example.com;
    ssl_certificate     /etc/ssl/certs/fullchain.pem;
    ssl_certificate_key /etc/ssl/private/privkey.pem;
    ssl_protocols TLSv1.2 TLSv1.3;
    location / { proxy_pass http://backend; }
}

加超时和重试

http.Client 默认没有 Timeout,网络抖动时会卡几分钟。建议加上:

client := &http.Client{
    Timeout: 10 * time.Second,
    Transport: &http.Transport{
        DialContext: (&net.Dialer{Timeout: 5 * time.Second}).DialContext,
    },
}

总结:Go 报 TLS certificate verify failed 或 server gave HTTP response,先查服务端 Nginx SSL 配置有没有配全。x509 错误用 RootCAs 加自定义 CA,HTTP response 错误修服务端。客户端加 Timeout 防挂死。

您可以还会对下面的文章感兴趣: