JavaScript中JSON与Protobuf互转异常问题排查

我有一个从JSON结构生成的.proto schema：

package mypackage;
syntax="proto3";

import "item.proto";
import "google/protobuf/any.proto";

message Header {
    uint32 status_code = 1;
    double execute_time = 2;
    string ip = 3;
}
message Body {
    repeated Item item_list = 1;
}
message Message {
    Header header = 1;
    Body body = 2;
}
message Response {
    Message message = 1;
}

其中item.proto内容如下：

package mypackage;
syntax = "proto3";

import "google/protobuf/any.proto";

message Thumbnail {
    string source = 1;
    uint32 width = 2;
    uint32 height = 3;
}
message Item {
    uint32 pageid = 1;
    string title = 2;
    string modified = 3;
    Thumbnail thumbnail = 10;
    string pageName = 12;
}

我使用protobuf库和proto3-json-serializer实现JSON与Protobuf的序列化/反序列化，编写了对应JavaScript代码。Message.verify(jsonResponse)返回验证通过，但编码后得到的Response对象仅ip字段有值，其他平级字段和嵌套数组item_list均为空；使用fromProto3JSON、toProto3JSON及fromObject方法也出现同样问题。请问是.proto定义有误还是提供的JSON对象存在问题？

你的.proto定义本身无语法错误，问题核心出在JSON结构/字段命名不符合proto3 JSON序列化规则，或代码中对象层级处理错误，具体分析如下：

1. 字段命名的驼峰/下划线映射不匹配 #

Proto3 JSON序列化默认遵循「下划线转驼峰」的命名规则：

• Proto中的status_code对应JSON的statusCode
• execute_time对应executeTime
• item_list对应itemList

如果你的JSON仍使用下划线命名这些字段，库会无法识别，导致赋值失败——只有ip这种无下划线的字段能正常被解析。

2. JSON层级结构未严格匹配Proto定义 #

你的Response类型是多层嵌套结构：Response -> Message -> Header/Body -> Item，JSON必须完全对应这个层级，不能缺失或错位。正确的JSON结构示例：

{
  "message": {
    "header": {
      "statusCode": 200,
      "executeTime": 0.123,
      "ip": "127.0.0.1"
    },
    "body": {
      "itemList": [
        {
          "pageid": 1,
          "title": "测试标题",
          "modified": "2024-05-20",
          "thumbnail": {
            "source": "test.png",
            "width": 200,
            "height": 200
          },
          "pageName": "test-page"
        }
      ]
    }
  }
}

若JSON未正确嵌套message、header、body等层级，会导致除ip外的字段无法被映射到对应Proto字段。

3. 库的使用类型混淆 #

• 你用Message.verify验证的是Message类型对象，但最终要序列化的是Response类型，若JSON包含完整的Response层级，用Message.verify会跳过外层的message字段，导致后续序列化时无法正确解析完整结构。
• 使用fromProto3JSON时，必须指定目标类型为Response，而非Message，否则会丢失外层结构信息。

排查修复步骤 #

1. 修正JSON字段名：将所有下划线命名替换为驼峰式；
2. 校验JSON层级：确保包含message -> header、message -> body -> itemList的完整嵌套；
3. 调整代码逻辑：序列化/反序列化时使用正确的目标类型（Response），避免类型混淆。

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