Go结构体嵌套protobuf消息子字段调用json.Marshal失败该如何处理？

安全阿岳

2026-10-7

问题解答

结论

不需要将protobuf类型的attributes子字段替换为原生Go结构体定义，序列化失败可通过对应规则修复。

失败原因排查

首先检查你自定义结构体的字段可导出性：你给出的示例中Animal的name字段首字母为小写，属于Go的私有字段，标准库json.Marshal的反射逻辑无法访问私有字段，会直接忽略该字段，可先修正为可导出的大写首字母格式Name string。
核心问题：Protobuf自动生成的Go消息类型（如*apb.Attributes）没有适配标准库encoding/json的序列化约定，直接用标准库序列化时要么输出大量protobuf内部冗余字段，要么直接报错。

可行解决方案

方案1：使用Protobuf官方JSON序列化工具（最推荐）

用google.golang.org/protobuf/encoding/protojson包替代标准库处理protobuf类型的序列化，若你的结构体混合了原生字段和protobuf字段，可给自定义结构体实现json.Marshaler接口统一处理：

import (
    "encoding/json"
    "google.golang.org/protobuf/encoding/protojson"
)

// 实现json.Marshaler接口，自定义序列化逻辑
func (a *Animal) MarshalJSON() ([]byte, error) {
    // 单独序列化protobuf类型字段
    attrJson, err := protojson.Marshal(a.attributes)
    if err != nil {
        return nil, err
    }
    // 构造临时结构体组装所有字段
    type TmpAnimal struct {
        Name string          `json:"name"`
        Attr json.RawMessage `json:"attributes"`
    }
    return json.Marshal(TmpAnimal{
        Name: a.name,
        Attr: attrJson,
    })
}

完成实现后直接调用标准库json.Marshal序列化Animal实例即可得到正确结果。