Go语言证书签发与自签名_Golang x509证书生成教程-Golang-PHP中文网

go标准库可纯内存生成自签名tls证书：需用crypto/x509构造含dnsnames、serialnumber（*big.int）、notbefore/notafter的证书模板，crypto/rsa生成私钥，x509.createcertificate签发，并用pem.encode正确封装为pem格式供tls.x509keypair加载。

go语言证书签发与自签名_golang x509证书生成教程

Go 语言标准库能直接生成自签名 TLS 证书，无需调用 openssl；但必须手动构造 x509.Certificate 模板、用 crypto/rsa 或 crypto/ecdsa 生成私钥，并正确 PEM 编码——漏掉 DNSNames、SerialNumber 类型错误、或私钥格式不匹配，都会导致 http.ListenAndServeTLS 启动失败或客户端报 x509: certificate is valid for XXX, not localhost。

为什么 `tls.X509KeyPair` 加载失败？

常见错误不是证书逻辑错，而是 PEM 块格式不合法：

cert.pem 必须以 -----BEGIN CERTIFICATE----- 开头、-----END CERTIFICATE----- 结尾，中间只能是 Base64 字符 + Unix 换行（\n），不能有 BOM、\r\n、空行或注释
key.pem 必须是 -----BEGIN PRIVATE KEY-----（PKCS#8）或 -----BEGIN RSA PRIVATE KEY-----（PKCS#1）；-----BEGIN OPENSSH PRIVATE KEY----- 不被支持
别把 DER 字节直接传给 tls.X509KeyPair：它只认完整 PEM 块，不是裸 []byte
用 os.ReadFile 读完后，先 fmt.Printf("%q", data[:20]) 看开头是否匹配，比盲目重试快得多

`x509.CreateCertificate` 自签名时必须设哪些字段？

自签名本质是用同一对密钥做 issuer 和 subject，但 x509.CreateCertificate 不校验 CA 属性，所以关键在模板字段是否合规：

Golang Samber Do

使用 samber/do 在 Golang 中实现依赖注入 — 服务容器、生命周期管理、作用域、健康检查、优雅关闭和模块组织

下载

SerialNumber 必须是 *big.Int，不能写 1 或 int64(1)，否则 panic：x509: serial number is negative
DNSNames 至少填 []string{"localhost"}；现代 TLS 栈（Chrome、Go、curl）忽略 CommonName，只看这个字段
IPAddresses 要支持 https://127.0.0.1，就得显式加 net.ParseIP("127.0.0.1")
NotBefore 建议设为 time.Now().Add(-5 * time.Minute)，防系统时间微偏差导致 “CERT_HAS_EXPIRED”
BasicConstraintsValid: true 且 IsCA: true 才能让客户端（如 curl --cacert）把它当根证书信任

如何避免每次启动都写磁盘文件？

开发阶段频繁重启时，把证书和私钥保留在内存里更可靠：

用 pem.Encode 将 derBytes（证书）和序列化后的私钥分别编码成 PEM 字节切片
确保两个字节切片都含完整 PEM 头尾，再传给 tls.X509KeyPair(pemCertBytes, pemKeyBytes)
别用 tls.LoadX509KeyPair 读文件——路径错、权限错、文件被锁都会中断启动流程

示例片段：

cert, err := tls.X509KeyPair(pemCertBytes, pemKeyBytes)
if err != nil {
    log.Fatal(err) // 这里会暴露 PEM 格式问题
}
srv := &http.Server{
    Addr: ":8443",
    TLSConfig: &tls.Config{Certificates: []tls.Certificate{cert}},
}

用 `openssl` 生成时为什么浏览器仍报 SAN 缺失？

因为老版 openssl req -x509 默认不写 subjectAltName 扩展，而现代 TLS 要求必须存在：

OpenSSL 1.1.1+ 支持 -addext 参数：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"
旧版 OpenSSL 需配 san.cnf 文件并指定 -config 和 -extensions
生成后用 openssl x509 -in cert.pem -text -noout | grep -A1 "Subject Alternative Name" 验证是否生效
Go 的 crypto/tls 对 SAN 检查比浏览器更严格，没 SAN 直接握手失败，不弹警告

最易被忽略的是：证书模板里 DNSNames 和 IPAddresses 是独立字段，填了 CommonName 不等于 SAN 自动补全；还有私钥必须用 x509.MarshalPKCS1PrivateKey（RSA）或 x509.MarshalECPrivateKey（ECDSA）序列化，直接传 *rsa.PrivateKey 给 pem.Encode 会输出乱码。