Go x509.ParseCertificate 读取扩展字段时怎么保留未知数据

用 Go 的 x509.ParseCertificate 解析证书时，未知扩展不会自动变成某个“未知字段”。正确做法是遍历解析结果里的 Certificate.Extensions，按 OID 找到对应的 pkix.Extension，保存它的 Critical 和 Value。如果还要重新生成证书，则把这些原始扩展复制到新模板的 ExtraExtensions，两者不能混用。

解析后，未知扩展到底放在哪里

ParseCertificate 接收 ASN.1 DER 数据，返回一个 *x509.Certificate。Go 已经认识的扩展会填充到 DNSNames、KeyUsage 等高层字段；没有专用字段的扩展仍以 pkix.Extension 形式留在 Extensions 中。

按 OID 保存 Value，而不是把未知数据转成字符串

下面的函数只做一件事：按 OID 找扩展并复制字节。复制很重要，因为调用方后续可能会复用或修改切片；把它转成字符串再保存，则会丢失二进制载荷的边界和编码语义。

package main

import (
    "crypto/x509"
    "encoding/asn1"
    "encoding/pem"
    "errors"
    "fmt"
)

// findExtension 按 OID 返回原始 Value 和 Critical 标志。
func findExtension(cert *x509.Certificate, want asn1.ObjectIdentifier) ([]byte, bool, error) {
    // Extensions 是解析结果；ExtraExtensions 只服务于后续生成。
    for _, ext := range cert.Extensions {
        if ext.Id.Equal(want) {
            // 复制二进制载荷，避免调用方持有内部切片的别名。
            value := append([]byte(nil), ext.Value...)
            return value, ext.Critical, nil
        }
    }
    return nil, false, errors.New("extension OID not found")
}

func parseCertificate(pemBytes []byte, oid asn1.ObjectIdentifier) ([]byte, bool, error) {
    block, _ := pem.Decode(pemBytes)
    if block == nil || block.Type != "CERTIFICATE" {
        return nil, false, errors.New("PEM certificate block not found")
    }
    cert, err := x509.ParseCertificate(block.Bytes)
    if err != nil {
        return nil, false, fmt.Errorf("parse certificate: %w", err)
    }
    // 只把目标扩展交给上层，未知结构仍保持原始字节。
    return findExtension(cert, oid)
}

如果你知道某个 OID 的 ASN.1 结构，可以只对返回的 Value 调用 asn1.Unmarshal。这一步是“理解扩展”，不是“保留扩展”；保留路径应始终以原始字节为准，解码失败也不应覆盖原值。

未知关键扩展不能被静默忽略

未知非关键扩展通常可以按上面的方式记录、转发或展示。但 Critical=true 表示验证方必须理解它的语义。Go 会把未完全处理的关键扩展 OID 放入 UnhandledCriticalExtensions；因此，保存到 Extensions 只解决了数据留存，不等于完成了证书验证。

func hasUnhandledCritical(cert *x509.Certificate) bool {
    // 非空表示仍有关键扩展没有被完整处理。
    return len(cert.UnhandledCriticalExtensions) != 0
}

// 使用时要把“原始数据已保存”和“证书可安全验证”作为两个结论。
if hasUnhandledCritical(cert) {
    fmt.Println("保留扩展，但先不要把证书标记为已验证")
}

不要为了让 Verify 通过而无条件清空这个切片。只有当业务代码确实按照该 OID 的规范完成了语义处理，才有理由把它从未处理集合中移除；否则应把它作为验证边界交给上层策略。

需要重新生成时使用 ExtraExtensions

Extensions 是解析侧的原始观察结果，而 ExtraExtensions 是创建证书时要直接写入的扩展集合。文档明确说明，解析证书不会填充 ExtraExtensions，并且 CreateCertificate 会忽略模板的 Extensions。

func copyExtensions(raw []pkix.Extension) []pkix.Extension {
    copied := make([]pkix.Extension, 0, len(raw))
    for _, ext := range raw {
        // 只传入确认需要保留的未知扩展，避免和高层字段生成同名扩展。
        copied = append(copied, pkix.Extension{
            Id:       append(asn1.ObjectIdentifier(nil), ext.Id...),
            Critical: ext.Critical,
            Value:    append([]byte(nil), ext.Value...),
        })
    }
    return copied
}

// newTemplate 是待重新签名的模板；unknownExtensions 由解析阶段筛出。
newTemplate.ExtraExtensions = copyExtensions(unknownExtensions)
// 私钥、父证书和业务字段需由调用方按实际证书链提供。
der, err := x509.CreateCertificate(rand.Reader, newTemplate, parent, publicKey, privateKey)

这不是原证书的字节级复制：重新签名会改变签名和部分编码布局，且高层字段可能重新生成同名扩展。若目标只是审计、转发或归档，直接保留原始 DER 更可靠；只有确实需要生成新证书时，才把未知扩展复制进 ExtraExtensions 并检查重复 OID。

相关问题

为什么 ExtraExtensions 读出来是空的？

它是生成侧字段，ParseCertificate 不会填充。解析现有证书应读取 Extensions。

Value 能直接当字符串存吗？

不建议。扩展载荷通常是 DER 编码的二进制，应该保存字节或十六进制；只有确认其字符编码后再转文本。

未知扩展会让 Verify 一定失败吗？

关键扩展未被完整处理时，Go 的验证路径会关注 UnhandledCriticalExtensions；普通未知扩展与关键未知扩展不能用同一条结论判断。

判断清单很简单：解析时从 Extensions 取原始值，按 OID 保存并复制字节；验证时检查关键扩展；生成时使用 ExtraExtensions。这样既不会因为“没有高层字段”丢掉数据，也不会把“保留成功”误写成“语义验证完成”。