Go启动HTTPS必须用http.ListenAndServeTLS，传含完整链的cert.pem和未加密、权限0600的key.pem；缺一或格式错将直接panic或握手失败。
Go 启动 HTTPS 服务必须用 http.ListenAndServeTLS，传两个 PEM 文件：含完整链的 cert.pem 和未加密、权限为 0600 的 key.pem；缺一或格式错，服务直接 panic 或握手失败。
证书文件为什么总报 “no certificate found” 或 “x509: certificate signed by unknown authority”
根本不是路径写错，而是内容或权限不合规：
-
cert.pem必须包含服务器证书 + 中间 CA（如 Let’s Encrypt 的fullchain.pem），不能只放域名证书；否则客户端无法构建信任链，报x509: certificate signed by unknown authority -
key.pem必须是未加密私钥（不含DEK-Info头），用openssl rsa -in key.pem.enc -out key.pem去密 - Linux/macOS 下私钥权限必须 ≤
0600，0644会被crypto/tls拒绝加载，错误日志却只显示tls: private key does not match public key（误导性信息） - Windows 上若用 CRLF 换行符，Go 解析失败；务必保存为 Unix 风格（LF）
自签名证书本地开发怎么让浏览器不报“不安全”
自签名本身没问题，问题在客户端没信任它。关键不是改 Go 代码，而是让浏览器认可这个证书：
- 生成时必须带 SAN（Subject Alternative Name）：
openssl req -x509 -newkey rsa:2048 -keyout key.pem -out cert.pem -days 365 -nodes -subj "/CN=localhost" -addext "subjectAltName = DNS:localhost,IP:127.0.0.1" - Chrome/Edge：地址栏点“不安全” → “证书” → “详细信息” → “复制到文件” → 导入系统根证书存储
- macOS：双击
cert.pem→ 拖进“钥匙串访问”，右键证书 → “显示简介” → “信任” → “始终信任” - Go 服务端无需任何额外配置，它只管握手；信任是纯客户端行为
为什么 TLSConfig 经常被忽略，以及哪些字段必须设
直接用 http.ListenAndServeTLS 看似简单，但默认配置不满足现代安全要求：
立即学习“go语言免费学习笔记（深入）”；
-
MinVersion: tls.VersionTLS12必须显式设置，否则默认支持 TLS 1.0/1.1，会被浏览器警告或安全扫描拦截 - 禁用弱 CipherSuites 不建议硬编码；Go 1.19+ 默认已优先 AEAD 套件，仅当需兼容旧设备时才裁剪，且只保留如
tls.TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256这类 - 若启用 mTLS，
ClientAuth必须设为tls.RequireAndVerifyClientCert，且ClientCAs必须是已加载的*x509.CertPool（不是文件路径！） -
TLSConfig必须在调用srv.ListenAndServeTLS前赋值，之后修改无效
HTTP 自动跳转 HTTPS 容易踩的坑
不能靠中间件或单服务实现，必须另起一个 HTTP server 监听 :80，并注意请求头污染风险：
- 别拼
"https://" + r.Host + r.URL.String()——r.Host可被恶意请求头篡改，r.URL.String()不保证含 query 或正确编码非 ASCII 路径 - 推荐写死可信域名：
http.Redirect(w, r, "https://example.com" + r.URL.RequestURI(), http.StatusMovedPermanently) - 若部署在 Nginx / ALB 后，Go 层应关闭 TLS，只检查
r.Header.Get("X-Forwarded-Proto") == "https"做逻辑判断，避免双重终止和循环跳转 - 监听 :80 的 HTTP server 必须单独
go http.ListenAndServe(":80", ...)，不能和 HTTPS 共用同一个http.Server
证书链顺序、私钥权限、SAN 字段、TLS 版本控制——这些地方任何一个出错，都不会报“配置错误”，而是表现为连接中断、握手失败或浏览器直接拒绝，调试时容易绕远路。最稳妥的做法是：启动前用 tls.LoadX509KeyPair("cert.pem", "key.pem") 预检，再用 openssl s_client -connect localhost:8443 -tls1_2 验证实际协商结果。
