Iris框架不内置Protobuf解析能力，需用google.golang.org/protobuf手动反序列化；ReadJSON()仅支持JSON文本，无法处理二进制Protobuf数据，否则报“json: cannot unmarshal binary data”错误。
Iris框架本身不内置Protobuf解析能力，必须依赖Go标准库的google.golang.org/protobuf手动反序列化。核心前提是：你得有原始.proto文件，且已用protoc生成对应Go结构体代码。
为什么不能直接用iris.Context.ReadJSON()解析Protobuf
因为ReadJSON()只处理JSON文本，而Protobuf是二进制格式——字节流里没有字段名、没有分隔符、不带类型标识，全靠预定义schema（即.proto）才能正确拆解。调用ReadJSON()读Protobuf二进制，只会得到乱码或invalid character错误。
- 常见错误现象：
json: cannot unmarshal binary data into Go value - 根本原因：HTTP body是
[]byte，但没经过Unmarshal到具体message类型 - Iris的
Context.Request().Body可直接读取原始字节，这是唯一可用入口
正确解析流程：从body读取→反序列化→校验
在Iris控制器方法中，按顺序执行三步操作，缺一不可：
- 调用
ctx.Request().Body获取io.ReadCloser，用io.ReadAll()转为[]byte（注意：别用ctx.PostValue或ctx.FormValue，它们只处理表单编码） - 用生成的
pb.XXX{}结构体调用proto.Unmarshal()，例如err := proto.Unmarshal(data, &msg) - 必须检查
err：常见失败包括unexpected EOF（body被截断）、invalid wire format（版本不匹配或数据损坏）
示例片段：
func (c *DataController) PostHandle(ctx iris.Context) {
data, err := io.ReadAll(ctx.Request().Body)
if err != nil {
ctx.StatusCode(400)
ctx.WriteString("read body failed")
return
}
var req pb.UploadRequest
if err := proto.Unmarshal(data, &req); err != nil {
ctx.StatusCode(400)
ctx.WriteString("protobuf parse failed: " + err.Error())
return
}
// 后续业务逻辑
}
如何处理没有.proto文件的遗留Protobuf数据
如果只有二进制数据、没有.proto定义，Iris无法原生解决——Go生态里没有运行时Schema推断机制。此时必须借助外部工具：
- 用
protobuf-decoder命令行工具先离线解析出JSON结构，人工逆向还原字段语义 - 或在调试阶段用Burp Suite加载
protobuf_decoder.py插件，实时查看HTTP流量中的明文字段 - 切勿尝试手写struct+
binary.Read硬解析：Protobuf使用变长整数（varint）、tag-length-value编码，字段顺序不固定，手动对齐极易出错
真正容易被忽略的点是：Protobuf反序列化失败时，err不是“可忽略的警告”，而是数据完整性已破坏的明确信号——生产环境必须拒绝该请求，不能降级用默认值填充后继续处理。
