asn1: structure error: tags don't match

完整的消息会附上期望的标签、实际找到的标签以及字段上下文，例如“tags don't match (16 vs {class:0 tag:2 ...}) ... AlgorithmIdentifier @2”。输入被截断时会产生同类错误“asn1: syntax error: data truncated”。在当前版本的 Go 中，这条消息来自公钥和 PKCS#8 解析器；x509.ParseCertificate 会把同样的错误报告为“x509: malformed certificate”。

Go encoding/asn1 — surfaced through crypto/x509 parsers

含义

Go 的 DER 解码器遇到的 ASN.1 标签与目标结构要求的不同——要么是把基本合法的 DER 解析进了错误的 Go 结构体，要么解析的根本不是 DER。消息中的数字是 ASN.1 标签（16 = SEQUENCE，2 = INTEGER，PEM 文件中的 13 = 开头的短横线），通常能准确指出搞混了什么。

原因

• 把 PEM 字节传给了 DER 解析器

  常见

  ParsePKIXPublicKey、ParsePKCS8PrivateKey 等函数接受的是原始 DER。没有先调用 pem.Decode 就把 PEM 文本（短横线加 base64）传给它们，是最常见的触发原因。（ParseCertificate 同样会拒绝 PEM 文本，报错为“x509: malformed certificate”。）

• 密钥容器用错了解析器

  常见

  把私钥或整张证书传给了 ParsePKIXPublicKey——每种容器的结构都不同，标签检查会在第一个出现差异的字段处发现用错了。私钥解析器之间用错时，报错信息更有帮助：对 PKCS#8 字节调用 ParseECPrivateKey 会提示“x509: failed to parse private key (use ParsePKCS8PrivateKey instead for this key format)”，反之亦然。

• 根本不是证书或密钥

  偶见

  把 64 字节的原始签名、JWT 或协议帧字节当作 ASN.1 解析。如果输入不是以 0x30（SEQUENCE）开头，任何 X.509 系列的解析器都不会接受。

修复方法

1. 1.

   始终先调用 pem.Decode

   在调用任何解析器之前，先提取 DER 块（并检查其类型标签）。

   block, _ := pem.Decode(pemBytes)
   if block == nil {
       return fmt.Errorf("input is not PEM")
   }
   cert, err := x509.ParseCertificate(block.Bytes)   // block.Type == "CERTIFICATE"

2. 2.

   按顺序尝试各种容器解析器

   不确定私钥的容器格式时，依次尝试 PKCS#8、SEC1、PKCS#1——这是处理来源各异的密钥时的标准排查顺序。

   if k, err := x509.ParsePKCS8PrivateKey(der); err == nil { return k, nil }
   if k, err := x509.ParseECPrivateKey(der); err == nil { return k, nil }
   if k, err := x509.ParsePKCS1PrivateKey(der); err == nil { return k, nil }
   return nil, errors.New("unrecognized private key format")

3. 3.

   查看开头的几个字节

   一行 hexdump 就能看出手里的到底是不是 DER，openssl asn1parse 则会显示结构，便于与所选的解析器对照。

   head -c 16 key.der | xxd          # 30 81/82 ... → SEQUENCE, plausibly DER
   openssl asn1parse -inform der -in key.der | head -3

← 浏览完整的签名错误库