Proto3中如何定义通用JSON类型的嵌套Map结构

安全阿岳

2026-9-30

Proto3有两种常用的通用嵌套Map实现方案，分别适配不同的使用场景：

方案1：使用`google.protobuf.Struct`（最适配通用场景）

这是最简单的通用解决方案，google.protobuf.Struct是Proto3原生提供的标准类型，本质就是可嵌套的字符串键映射结构，完美对应任意层级的map<string, 任意类型>结构，无需自定义任何消息。

用法示例

syntax = "proto3";

// 引入原生Struct定义
import "google/protobuf/struct.proto";

message TimeSeriesResponse {
  string base = 1;
  // rates字段完全匹配你需要的嵌套Map结构：外层key为日期字符串，内层key为货币代码，value为汇率值
  google.protobuf.Struct rates = 2;
}

优缺点

优点：无需自定义消息，支持任意层级、任意值类型的嵌套结构，和JSON格式互转零损耗，非常适配从第三方API拉取JSON数据的场景，所有主流语言的Protobuf库都提供了直接将Struct转成语言原生嵌套字典/Map的工具方法，无需额外写适配逻辑。
缺点：Proto层面无法约束值的类型，类型校验需要在业务代码中实现。

方案2：定义通用包装消息（适配值类型固定的场景）

如果你的嵌套Map的值类型是固定的（比如汇率场景内层值全是浮点数），可以定义一个可复用的通用Map包装消息，后续所有同类型的嵌套Map场景都可以直接复用，不需要每个业务单独定义新消息。

用法示例

syntax = "proto3";

// 通用的string到float的Map包装消息，所有同类型场景可复用
message FloatMap {
  map<string, float> entries = 1;
}

// 通用的string到字符串的Map包装消息，可按需扩展其他类型
message StringMap {
  map<string, string> entries = 1;
}

message TimeSeriesResponse {
  string base = 1;
  // 外层是日期到FloatMap的映射，完全等价于你需要的map<string, map<string, float>>结构
  map<string, FloatMap> rates = 2;
}