如何用Protobuf处理Map值为对象或对象数组的两种响应场景？

现有如下Protobuf消息定义：

message {
   message leadsEntity{
     optional string name = 1;
   }
   optional string description = 1;
   map <string, leadsEntity>  entity = 2;
}

存在两种JSON响应格式：

第一种情况 #

{
   "description": "this is test",
   "entity": {
     "key1": { "name": "name1" },
     "key2": { "name": "name2" }
   }
}

第二种情况 #

{
   "description": "this is test",
   "entity": {
     "key1": { "name": "name1" },
     "key2": [ { "name": "name2" } ] // 值为数组形式
   }
}

当前消息定义可完美适配第一种场景，但如何处理第二种Map值为对象数组的场景？

Protobuf的map类型要求值的类型固定，没法直接兼容“单个对象/对象数组”的混合结构，可通过以下几种方式处理：

1. 统一Map值为数组类型（推荐） #

直接把map的值改成leadsEntity的数组类型，这样两种场景都能兼容——第一种场景的单个对象可以存为单元素数组，第二种场景直接用数组：

message {
   message leadsEntity{
     optional string name = 1;
   }
   optional string description = 1;
   map <string, repeated leadsEntity>  entity = 2;
}

这种方式符合Protobuf的设计规范，序列化和反序列化都不需要额外逻辑，是最稳妥的方案。

2. 用oneof区分单个/多个实体 #

如果需要明确区分“单个对象”和“数组”的场景，可以定义一个嵌套消息，通过oneof包含两种值类型：

message {
   message leadsEntity{
     optional string name = 1;
   }
   message EntityValue {
     oneof value {
       leadsEntity single = 1;
       repeated leadsEntity multiple = 2;
     }
   }
   optional string description = 1;
   map <string, EntityValue>  entity = 2;
}

使用时需要在业务代码中判断EntityValue的具体类型，适合对数据结构有严格区分需求的场景。

3. 自定义JSON解析逻辑（不推荐） #

如果无法修改Protobuf定义，只能在JSON序列化/反序列化层做兼容：

• 反序列化时，若遇到entity中的数组值，可根据业务规则取第一个元素，或者将数组转换为符合leadsEntity的结构；
• 序列化时，将单个对象包装为数组输出。
  这种方式属于临时 workaround，容易引发兼容性问题，仅适合无法修改Protobuf定义的极端场景。

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