登录
推荐 文章 Go 技术 课程 下载 专题 AI
首页 >  Golang >  Go教程

Go encoding/asn1.RawValue 怎样保留 ASN.1 原始编码

来源:17golang原创

时间:2026-11-17 06:50:06 475浏览 收藏

结论先说:asn1.RawValue 适合接住“现在还不想解析、但以后还要原样写回”的 ASN.1 对象。Bytes 只保存对象内容,FullBytes 保存包含标签和长度的完整 DER 编码;从字节流反序列化后直接透传时,应保留 FullBytes。如果要修改内容,就必须清空旧的 FullBytes,让 Marshal 按 Class、Tag、IsCompound 和新的 Bytes 重新生成编码。

这个类型很适合做协议中间层:上游发来一个暂时未知的字段,中间服务不需要理解它的内部类型,只要先保留原始对象,后面再交给下游。真正容易出错的地方不是 Unmarshal,而是没有分清“内容字节”和“完整对象字节”,或者改了 Bytes 却忘了旧的 FullBytes 仍然优先级更高。

RawValue 里的两组字节分别表示什么

Go 官方把 RawValue 定义为一个未解码的 ASN.1 对象,字段包括 Class、Tag、IsCompound、Bytes 和 FullBytes。可以把 DER 对象抽象成“标签 + 长度 + 内容”三层:

字段覆盖范围适合做什么
Class、Tag对象的类型标识识别或重建标签
IsCompound对象是否包含嵌套对象重建复杂对象时保留结构属性
Bytes标签和长度之后的内容读取或替换对象内容
FullBytes从标签开始到内容结束的完整编码未知对象原样透传

例如,一个 OCTET STRING 的 DER 字节可以抽象成 04 03 61 62 63:04 是标签,03 是长度,后面的 61 62 63 是内容。此时 Bytes 对应 61 62 63,而 FullBytes 对应整段 04 03 61 62 63。

DER 标签长度内容三层与 Go RawValue 的 Bytes、FullBytes 字段映射结构说明图
图1:RawValue 字节层次结构图,区分 Bytes 与 FullBytes 的覆盖范围;它是静态说明图,不是运行截图。

用 Unmarshal 接住暂时未知的对象

如果当前只关心对象的边界,不关心它是不是 INTEGER、OCTET STRING 或上下文标签,可以直接把目标声明为 asn1.RawValue。下面的输入只展示一个最小 DER 对象,代码重点是读取两组字节的差异:

package main

import (
    "encoding/asn1"
    "encoding/hex"
    "fmt"
)

func main() {
    // 04 表示 OCTET STRING,03 是内容长度,后面三个字节是内容本身。
    der := []byte{0x04, 0x03, 0x61, 0x62, 0x63}
    var raw asn1.RawValue

    // RawValue 只读取对象边界和原始字段,不继续解释内容的业务类型。
    rest, err := asn1.Unmarshal(der, &raw)
    if err != nil {
        // 输入不是合法 DER 时,不能把残缺的 RawValue 继续交给下游。
        panic(err)
    }

    // Bytes 只有内容;FullBytes 包含标签、长度和内容。
    fmt.Println(raw.Class, raw.Tag, raw.IsCompound)
    fmt.Println(hex.EncodeToString(raw.Bytes))
    fmt.Println(hex.EncodeToString(raw.FullBytes))
    fmt.Println(len(rest))
}

这里的 rest 也有实际意义:Unmarshal 只消费一个 ASN.1 对象,输入后面如果还有字节,它们会作为剩余数据返回。做连续对象解析时,下一轮应继续处理 rest,不要误以为一次调用一定消费完整缓冲区。

不理解内容时,直接用 FullBytes 原样透传

透传场景的目标是“读进来什么,写出去还是什么”。asn1.Marshal 对 RawValue 的处理有一个关键顺序:当 FullBytes 非空时,优先使用它;只有没有完整字节时,才根据其他字段重新拼出标签、长度和内容。

package main

import (
    "bytes"
    "encoding/asn1"
    "fmt"
)

func roundTrip(der []byte) ([]byte, error) {
    var raw asn1.RawValue

    // 先保存未解码对象,让中间层不必知道字段内部的 ASN.1 类型。
    rest, err := asn1.Unmarshal(der, &raw)
    if err != nil {
        return nil, fmt.Errorf("decode raw ASN.1 object: %w", err)
    }
    if len(rest) != 0 {
        // 这个函数只接收一个对象,额外字节交给调用方处理更清楚。
        return nil, fmt.Errorf("unexpected trailing bytes: %d", len(rest))
    }

    // 没有修改对象时保留 FullBytes,Marshal 会按原始 DER 字节透传。
    encoded, err := asn1.Marshal(raw)
    if err != nil {
        return nil, fmt.Errorf("encode raw ASN.1 object: %w", err)
    }
    if !bytes.Equal(encoded, der) {
        return nil, fmt.Errorf("raw object changed during round trip")
    }
    return encoded, nil
}

这条路径的价值在于“中间服务不需要拥有所有协议知识”。比如协议增加了一个新字段,旧服务仍然可以把这个字段作为 RawValue 暂存并写回,而不是因为无法映射到具体 Go 类型就把它丢掉。

修改内容时,为什么必须清空 FullBytes

如果需求从“透传”变成“改内容”,处理方式就要换一条路径。下面这段代码故意把 Bytes 改成 xyz,同时把 FullBytes 设为 nil,这样 Marshal 才会重新计算长度并生成新的完整编码:

package main

import (
    "encoding/asn1"
    "encoding/hex"
    "fmt"
)

func replacePayload(der []byte, payload []byte) ([]byte, error) {
    var raw asn1.RawValue

    // 先读取原对象,保留它的 Class、Tag 和复合结构属性。
    if _, err := asn1.Unmarshal(der, &raw); err != nil {
        return nil, fmt.Errorf("decode raw object: %w", err)
    }

    // 修改内容后,旧 FullBytes 已经代表旧内容,必须让它失效。
    raw.Bytes = append([]byte(nil), payload...)
    raw.FullBytes = nil

    // Marshal 会根据旧标签和新内容重新计算长度字段。
    encoded, err := asn1.Marshal(raw)
    if err != nil {
        return nil, fmt.Errorf("rebuild raw object: %w", err)
    }
    fmt.Println(hex.EncodeToString(encoded))
    return encoded, nil
}

反过来,如果只改 raw.Bytes 而保留非空的 raw.FullBytes,重新 Marshal 时仍可能输出旧的完整字节。这是 RawValue 最容易造成“明明改了字段,结果却没变”的原因。可以把它记成一句话:不改对象就保留 FullBytes;改对象就清空 FullBytes 再编码。

RawValue 原样透传与修改 Bytes 后清空 FullBytes 重新编码的流程对比图
图2:RawValue 透传与重建流程图,查看什么时候保留完整字节、什么时候按字段重新编码;它是静态说明图,不是运行结果截图。

RawValue 和 RawContent 不要混为一谈

两者都和“保留原始 DER”有关,但边界不同:

类型保留对象典型用途注意点
RawValue一个字段或一个 ASN.1 对象未知字段透传、按对象边界转发FullBytes 非空时优先原样输出
RawContent包含它的整个结构体内容结构体级别保留未解码的 DER 内容必须是结构体的第一个字段

如果只是想让结构体中的某个扩展字段穿过中间层,用 RawValue 更直观;如果要保留整个结构体被解析前的原始内容,才考虑把 RawContent 放在结构体首字段。不要把 RawContent 当成任意字段类型使用,官方实现对它的位置有明确限制。

落地时可以按这张表选路径

需求操作关键判断
只想识别对象边界Unmarshal 到 RawValue检查 err 和剩余字节
未知字段原样转发直接 Marshal(raw)保留 FullBytes
替换内容更新 Bytes 后 FullBytes = nil让编码器重新计算长度
重建不同标签同时设置 Class、Tag、IsCompound 和 Bytes不能只改内容而忽略标签语义
保留结构体整体把 RawContent 放在结构体首字段不要把它放到普通字段中

相关问题

Bytes 和 FullBytes 有什么区别?Bytes 是标签和长度之后的内容,FullBytes 是包含标签、长度和内容的完整 DER 对象。

改了 Bytes 后为什么 Marshal 还是旧值?因为旧的 FullBytes 仍然非空,编码器优先使用它;修改内容后应将 FullBytes 置空。

RawValue 能不能解析证书里的所有字段?它只负责把对象作为未解码值保存,不会替你完成证书语义解析;需要理解字段时仍应定义合适的 Go 类型。

RawContent 和 RawValue 怎么选?字段级未知对象选 RawValue,结构体整体原始内容保留选首字段位置的 RawContent。

官方参考:https://pkg.go.dev/encoding/asn1#RawValue、https://pkg.go.dev/encoding/asn1#RawContent。

声明:本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>