基于Python3的HTTP服务解析Protobuf请求体后字段为空，如何解决？

最可能的核心原因：Proto定义和生成的Python代码不匹配 #

这是90%以上该类问题的根因：

• 你修改了Proto协议定义后，没有重新执行protoc命令生成最新的*_pb2.py文件，Python代码里导入的还是旧版本生成的代码，字段号、字段名、消息结构和你当前的Proto定义不一致。
• 你导入的HttpRequest类来自错误的*_pb2.py文件，并不是由你贴出的这份Proto生成的。

Protobuf的解析逻辑是兼容未知字段的，只要传入的是合法的Protobuf二进制数据，哪怕字段和当前消息定义完全不匹配，ParseFromString也不会抛出异常，只会把匹配不到的字段丢到未知字段池里，所以你会看到解析不报错但所有字段都是默认空值。

其他可能的原因 #

• HTTP请求体读取不完整：你使用的Web框架没有完整读取整个POST请求的Body，传入ParseFromString的是截断后的二进制数据。
• 二进制数据被篡改：Web框架因为错误的Content-Type配置，自动对请求体做了编码转换（比如把二进制当成UTF-8字符串转码），导致最终传入解析方法的bytes和客户端发送的原始Protobuf序列化数据不一致。
• Proto语法版本不匹配：生成Python代码时指定的proto2/proto3语法，和你编写的Proto文件的语法声明不一致。

快速验证方法 #

1. 执行下面的代码打印解析结果的字段列表，确认是否有未识别的未知字段：

message = HttpRequest()
message.ParseFromString(data)
# 打印所有解析到的字段
print(message.ListFields())
# 打印所有未匹配到定义的未知字段
print(message.UnknownFields())

如果输出为空或者只有未知字段，直接确认你的*_pb2.py生成时间和Proto修改时间，重新执行protoc生成代码即可解决。
2. 你也可以直接用protoc命令行工具验证二进制数据的合法性：将示例二进制数据写入文件后，执行以下命令，如果能正常解析出字段值，即可100%确认是Python侧导入的Pb代码版本错误：

protoc --decode=HttpRequest 你的Proto文件路径.proto < 二进制数据文件路径.bin

内容的提问来源于stack exchange，提问作者Zohar81