如何为JavaScript定义适用于动态JSON数据的Protobuf消息

一、正确使用Protobuf Struct类型（推荐） #

你之前用Struct没成功，大概率是序列化/反序列化环节没处理到位，JS端必须用官方工具类做转换：

• Proto文件定义
  直接引入官方Struct类型来声明动态数组：

syntax = "proto3";
import "google/protobuf/struct.proto";

service DataService {
  rpc FetchDynamicItems (EmptyReq) returns (DynamicRes);
}

message EmptyReq {}

message DynamicRes {
  repeated google.protobuf.Struct items = 1;
}

• 发送端（服务端）序列化
  用google-protobuf库的Struct.fromJavaScript()把普通JS对象转成Struct实例，再添加到响应中：

const { Struct } = require('google-protobuf/google/protobuf/struct_pb');
const { DynamicRes } = require('./your_proto_pb');

// 模拟动态嵌套JSON数组
const dynamicItems = [
  { id: 1, meta: { name: "demo", tags: ["grpc", "js"] } },
  { id: 2, meta: { name: "test", stats: { hits: 100 } } }
];

const response = new DynamicRes();
dynamicItems.forEach(item => {
  const structItem = Struct.fromJavaScript(item);
  response.addItems(structItem);
});

• 接收端（客户端）反序列化
  调用Struct实例的toJavaScript()方法，直接转回可使用的JS嵌套对象：

// 处理gRPC响应
response.getItemsList().forEach(structItem => {
  const jsObj = structItem.toJavaScript();
  console.log(jsObj); // 输出完整嵌套结构
});

二、用Bytes类型直接传递JSON字符串（灵活方案） #

如果觉得Struct约束太繁琐，也可以直接把动态JSON序列化成字符串，转成Bytes传递：

• Proto文件定义

syntax = "proto3";

service DataService {
  rpc FetchDynamicItems (EmptyReq) returns (DynamicRes);
}

message EmptyReq {}

message DynamicRes {
  bytes raw_json = 1;
}

• 发送端处理

const { DynamicRes } = require('./your_proto_pb');
const dynamicItems = [/* 你的动态嵌套数组 */];
const jsonStr = JSON.stringify(dynamicItems);
const response = new DynamicRes();
response.setRawJson(Buffer.from(jsonStr, 'utf8'));

• 接收端处理

const jsonBuffer = response.getRawJson();
const dynamicItems = JSON.parse(jsonBuffer.toString('utf8'));
// 直接使用dynamicItems即可

关于proto3 JSON在JS的兼容性说明 #

你提到的proto3 JSON在JS端的支持问题，目前google-protobuf库已支持toJSON()和fromJSON()方法，但针对动态嵌套结构，上面两种方案更可靠：Struct方案符合Protobuf类型规范，Bytes方案完全绕开类型约束，适合极度动态的场景。

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