现象: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 防挂死。
