Go x509.CreateCertificate 怎样生成带 SAN 的本地测试证书

如果目标是给本地 HTTPS、httptest 或集成测试准备一张带 localhost SAN 的证书，推荐直接使用 crypto/x509.CreateCertificate：代码可以明确控制 DNS SAN、KeyUsage、有效期和签名关系，返回的 DER 再用 PEM 包装即可。它适合测试材料生成，不等于向浏览器或生产系统申请受信任证书。

本文使用的官方地址：https://pkg.go.dev/crypto/x509#CreateCertificate

先按场景选方案

先把三种方式放在同一个选择表里，能避免把测试工具和证书生产流程混在一起：

因此，测试只需要服务和客户端时可以优先选 httptest.NewTLSServer；需要保存证书、复用 SAN 或给多个测试进程加载时，再选 CreateCertificate。如果团队已经有跨语言证书脚本，OpenSSL 才更有现实优势。

模板、签名者和 SAN 应该怎样对应

CreateCertificate 的参数可以按四个角色理解：template 描述要生成的证书，parent 是签名者证书，pub 是新证书对应的公钥，priv 是签名者私钥。自签名测试证书把 parent 设为同一个模板，但它仍然需要用私钥签名。

标题中的 SAN 对应 Certificate.DNSNames，不要只写 Subject.CommonName 后期待现代主机名校验自动通过。下面的示例把 localhost 和 example.test 放入 DNS SAN，同时把用途限制为服务端认证：

package main

import (
    "crypto/ecdsa"
    "crypto/elliptic"
    "crypto/rand"
    "crypto/x509"
    "crypto/x509/pkix"
    "encoding/pem"
    "fmt"
    "math/big"
    "time"
)

func makeLocalCertificate() ([]byte, []byte, error) {
    // 使用随机椭圆曲线私钥，公钥会写入待生成的证书。
    key, err := ecdsa.GenerateKey(elliptic.P256(), rand.Reader)
    if err != nil {
        return nil, nil, fmt.Errorf("生成密钥失败: %w", err)
    }

    // 序列号、有效期、SAN 和用途共同描述测试证书的边界。
    serial, err := rand.Int(rand.Reader, new(big.Int).Lsh(big.NewInt(1), 128))
    if err != nil {
        return nil, nil, fmt.Errorf("生成序列号失败: %w", err)
    }
    now := time.Now()
    template := &x509.Certificate{
        SerialNumber:          serial,
        Subject:               pkix.Name{CommonName: "localhost"},
        DNSNames:              []string{"localhost", "example.test"},
        NotBefore:             now.Add(-time.Minute),
        NotAfter:              now.Add(24 * time.Hour),
        KeyUsage:              x509.KeyUsageDigitalSignature,
        ExtKeyUsage:           []x509.ExtKeyUsage{x509.ExtKeyUsageServerAuth},
        BasicConstraintsValid: true,
    }

    // parent 与 template 相同表示自签名；返回值仍是 DER 二进制。
    der, err := x509.CreateCertificate(rand.Reader, template, template, &key.PublicKey, key)
    if err != nil {
        return nil, nil, fmt.Errorf("生成证书失败: %w", err)
    }

    // 证书用 CERTIFICATE 包装；私钥用 PKCS#8 包装，便于测试夹具保存。
    certPEM := pem.EncodeToMemory(&pem.Block{Type: "CERTIFICATE", Bytes: der})
    keyDER, err := x509.MarshalPKCS8PrivateKey(key)
    if err != nil {
        return nil, nil, fmt.Errorf("编码私钥失败: %w", err)
    }
    keyPEM := pem.EncodeToMemory(&pem.Block{Type: "PRIVATE KEY", Bytes: keyDER})
    if certPEM == nil || keyPEM == nil {
        return nil, nil, fmt.Errorf("PEM 包装失败")
    }
    return certPEM, keyPEM, nil
}

这里的 template 同时充当 parent，所以是自签名模型；key.PublicKey 是证书主体的公钥，key 是签名私钥。证书输出先是 DER，pem.EncodeToMemory 只负责把 DER 放进可保存、可传输的 PEM 外壳。

生成后怎样接入本地 TLS 测试

如果只是保存夹具，可以把两个返回值写入测试目录；如果由 Go 测试进程加载，则用 tls.X509KeyPair(certPEM, keyPEM) 组成服务端证书。客户端是否信任它是另一件事：自签名证书不在系统根证书池中，测试客户端通常需要把这张证书加入自定义 x509.CertPool，而不是把正式代码改成跳过证书校验。

cert, key, err := makeLocalCertificate()
if err != nil {
    return err
}

// tls.X509KeyPair 读取 PEM；测试客户端仍需显式信任自签名证书。
pair, err := tls.X509KeyPair(cert, key)
if err != nil {
    return fmt.Errorf("加载测试证书失败: %w", err)
}
_ = pair

上面的片段只展示加载关系，完整服务端还需要把 pair 放进 tls.Config.Certificates。代码示例没有把证书写入真实系统目录，也没有把跳过校验当成解决方案。

常见误区与选型结论

• SAN 漏写：只设置 CommonName 不能替代 DNSNames 或 IPAddresses。
• 签名者混淆：子证书使用 CA 模板签名时，parent、签名私钥和新证书公钥不是同一组角色。
• PEM 与 DER 混淆：CreateCertificate 返回 DER，不能把它直接当作带头尾的 PEM 文本。
• 把测试证书当生产证书：自签名材料只服务本地或受控测试，生产环境应使用合规 CA 和正式密钥管理流程。

最终选择可以压缩成一句话：需要一个短小、可控、可复用的 Go 测试证书，就选 x509.CreateCertificate；只需临时 HTTPS 服务，就选 httptest.NewTLSServer；已有跨语言脚本时才保留 OpenSSL。先把 SAN、信任根和证书用途分开，排查会清楚很多。

相关问题

为什么 localhost 证书还要写 DNSNames？

因为主机名匹配应读取 SAN。访问 IP 地址时，应把 IP 放进 IPAddresses，不要把 IP 当作 DNS 名称。

自签名证书生成成功，客户端为什么仍然不信任？

生成成功只说明签名和编码完成，不代表它已经进入客户端信任根。测试客户端需要显式把证书加入自定义根池，或使用专门的测试服务器客户端。