Go crypto/tls 怎样读取连接本地证书链

Go 中要读取一条 TLS 连接实际向对端呈现的本地证书链，可以在握手成功后获取 conn.ConnectionState().LocalCertificate，再用 x509.ParseCertificate 逐张解析。这个字段由 Go 1.27 引入；它保存的是本端证书的 DER 字节切片，不是对端证书，也不是配置文件中全部可选证书。

同时记录 DidResume：官方文档明确说明，恢复会话时不会填充 LocalCertificate。因此，“字段为空”和“本次完整握手没有提供本地证书”不能直接画等号。这个限制是日志设计必须保留的语义。

Go 官方地址：https://go.dev/

日志里的证书为什么不是自己发出的那一张

设想一个教学用排障场景：服务支持多个域名，轮换证书后，日志里的序列号仍与运维预期不同。第一种写法直接读 Config.Certificates[0]，第二种写法改读 PeerCertificates[0]，两种都可能答非所问。这里没有引用真实事故或实测日志，而是用这个场景说明观测位置的选择。

排查过程可以分为三个判断：先确认日志对象属于哪一端；再确认配置中有哪些候选证书；最后回到目标连接的握手状态。配置说明“可以选谁”，连接状态说明“这条连接呈现了什么”。把三者混为一谈，才会出现证书轮换后日志看起来没变化的错觉。

把取证位置放在握手成功之后

拿到 *tls.Conn 并不意味着握手已经完成。原始 TLS 连接包装与已经完成握手的拨号路径不能混着看；统一的做法是在自己的连接处理边界调用 HandshakeContext，成功后再取状态。若握手失败，应记录失败原因，而不是继续生成一份看起来正常的证书报告。

下面的辅助函数用于已有连接，既不重新拨号，也不修改信任配置。把它放入现有 Go 1.27 项目的普通包即可。函数保留调用方对连接的所有权，超时由传入的上下文决定。

用状态和 DER 解析替代猜测

package certobserve

import (
    "context"
    "crypto/sha256"
    "crypto/tls"
    "crypto/x509"
    "fmt"
    "time"
)

// CertMeta 只保存定位轮换所需的信息，不包含私钥。
type CertMeta struct {
    Position int
    SHA256 string
    Serial string
    NotAfter time.Time
}

type LocalReport struct {
    Status string
    DidResume bool
    Chain []CertMeta
}

// ReadLocal 不接管连接所有权，调用方仍负责关闭连接。
func ReadLocal(ctx context.Context, conn *tls.Conn) (LocalReport, error) {
    if conn == nil {
        return LocalReport{}, fmt.Errorf("TLS 连接为空")
    }
    // 必须处理握手错误；不要把失败连接当成完整证书记录。
    if err := conn.HandshakeContext(ctx); err != nil {
        return LocalReport{}, fmt.Errorf("TLS 握手失败: %w", err)
    }
    state := conn.ConnectionState()
    report := LocalReport{DidResume: state.DidResume}
    if state.DidResume {
        // 恢复连接的空字段不等同于本地证书缺失。
        report.Status = "resumed-not-populated"
        return report, nil
    }
    if len(state.LocalCertificate) == 0 {
        report.Status = "no-local-chain"
        return report, nil
    }
    report.Status = "local-chain-present"
    for i, der := range state.LocalCertificate {
        // 每个元素是一张 DER 证书，不能直接当作 PEM 文本。
        cert, err := x509.ParseCertificate(der)
        if err != nil {
            return LocalReport{}, fmt.Errorf("解析本地证书位置 %d: %w", i, err)
        }
        sum := sha256.Sum256(der)
        report.Chain = append(report.Chain, CertMeta{
            Position: i,
            SHA256: fmt.Sprintf("%x", sum),
            Serial: cert.SerialNumber.String(),
            NotAfter: cert.NotAfter,
        })
    }
    return report, nil
}

这里返回三种明确状态，而不是一个含糊的“未找到证书”。resumed-not-populated 表示恢复会话不提供该观测字段；no-local-chain 表示完整握手后没有本地链可读；local-chain-present 则可以继续查看每个位置的指纹与元数据。解析失败会带上证书位置，便于区分握手失败与数据解析失败。

LocalCertificate 的类型是 [][]byte，循环内每个 der 都作为单张 ASN.1 DER 证书解析。不要把它直接转成字符串当成 PEM，也不要把整条二维切片交给只接收单张字节数据的函数。读取元数据不等于验证信任：ParseCertificate 只完成解析，本例没有用它代替 TLS 本身的证书验证。

在已有业务函数中的调用片段如下，五秒只是示例预算，应结合已有请求上下文确定：

// 此片段放在已有 TLS 连接 conn 的业务函数中；需导入 context、time。
// 超时由上层管理，不为读取观测信息关闭正常的证书验证。
ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
defer cancel()

report, err := ReadLocal(ctx, conn)
if err != nil {
    return err // 把握手或解析错误交给已有错误处理路径
}
// report 可写入受控日志；conn 的关闭仍由原来的连接管理者负责。
_ = report

示例没有附带伪造输出。读者接入自己的连接后，应根据 Status 判断日志分支，而不是期待某个固定序列号、链长度或有效期。

动态选证书时不要回读配置第一项

多域名服务可能由 GetCertificate 选择本地服务端证书，客户端身份认证也可能由 GetClientCertificate 选择证书。候选列表、选择回调和最终连接记录各有职责；回读第一项不会自动重演当前连接的选择结果。尤其在热更新场景中，当前配置库存还可能已经与建立连接时不同。

本例把 ConnectionState 作为当前连接的观测入口，不再尝试通过请求域名倒推某个配置下标。若需要跨日志追踪，可以为配置快照保留自己的业务版本号，并与连接报告关联；这个版本号是应用元数据，不属于 LocalCertificate。不要为了日志方便修改握手后获得的证书字节或共享配置内容。

把恢复会话单独记账

同一个服务地址的两次连接，不一定执行相同的证书交换过程。DidResume 为真时，本例直接返回独立状态，不从配置中补一条“推测链”。这样日志表达的是“这个连接没有提供可用的本地链字段”，而不是“这个服务没有证书”。也不能用上一次连接的证书强行覆盖本次空值。

客户端连接普通 HTTPS 服务时，若没有提供客户端证书，本地链为空通常与其角色相符；要查看服务端证书，应读取该客户端连接的 PeerCertificates。服务端观察本地证书时，同样要先分清这条连接是否恢复。不要为了让字段非空，在生产系统里随手关闭会话恢复或降低 TLS 验证要求。

如需定位证书轮换，可以在授权的测试环境中对照完整握手与恢复连接，分别记录状态、连接关联标识和证书指纹。这里提出的是接入后的排障动作，不声称已经在本机执行。旧工具链若没有这个字段，不能仅靠修改 go.mod 就取得新标准库 API，应使用支持它的构建工具链。

让证书日志保留问题的上下文

防止类似误判，重点不是多打印一整段 PEM，而是让记录携带角色、握手是否成功、是否恢复、链长度和必要的指纹。指纹适合区分同名证书；序列号和到期时间方便与内部证书清单关联，但不应因此向公开日志输出私钥、内部域名清单或完整证书内容。

这类日志用于解释连接，不应重新定义认证策略。不要设置 InsecureSkipVerify 来“修复空链”，不要用 VerifiedChains 填充本地链，也不要把本地解析成功当成对端认证成功的证明。连接失败、恢复会话、无本地链和有本地链，应是四种能分开的业务记录。

LocalCertificate 能读到私钥吗？

不能。它是证书链的字节数据，不是 tls.Certificate 配置对象，更不是私钥导出接口。本例也不会访问私钥。

读到本地链就说明对方接受了吗？

不能这样推断。它表示本端呈现的链；对端如何做身份认证、授权或业务放行，仍需对端的协议和应用结果来说明。

为什么同一地址有时有链、有时没有？

先看 DidResume，再看连接角色和是否需要本地身份认证。把这些条件与链长度放在同一条记录中，比只根据空切片触发故障告警更有解释力。

相关官方资料：Go 1.27 crypto/tls 变更、ConnectionState 字段说明、X.509 证书解析接口。