NodeJS中返回google.protobuf.Struct仅含fields空对象问题排查

你出错的核心原因是：google.protobuf.Struct类型不能直接赋值普通JavaScript对象，它有固定的内部结构规范，protobuf库无法自动将普通对象转换为符合Struct要求的格式，所以才会返回空的fields。

Struct类型的正确结构 #

google.protobuf.Struct的格式要求是包含fields字段，每个属性值必须是google.protobuf.Value类型（对应不同类型的子字段，比如stringValue、numberValue等），示例结构如下：

{
  "fields": {
    "name": { "stringValue": "Test Workspace" },
    "id": { "stringValue": "sampleId" }
  }
}

两种解决方法 #

方法一：手动构造符合Struct格式的对象

直接按照Struct的规范构造对象：

let sample = {
  fields: {
    name: { stringValue: "Test Workspace" },
    id: { stringValue: "sampleId" }
  }
};
callback(null, { workspace: sample });

方法二：使用protobuf工具函数自动转换

借助google-protobuf库提供的Struct.fromJavaScript方法，自动将普通JS对象转换为Struct格式：

1. 确保已安装依赖：

npm install google-protobuf

2. 修改服务端代码：

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

let sample = {
  "name": "Test Workspace",
  "id":"sampleId"
};
// 将普通对象转换为Struct实例
const workspaceStruct = Struct.fromJavaScript(sample);
// 转换为可序列化的JSON对象（适配多数RPC框架的要求）
callback(null, { workspace: workspaceStruct.toJSON() });

这样客户端就能收到符合预期的结构化数据了。

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