如何用Protobuf反射替代已废弃的proto.GetProperties？

是的，你需要使用google.golang.org/protobuf下的反射API替代旧的proto.GetProperties，核心依赖是google.golang.org/protobuf/reflect/protoreflect包，配合google.golang.org/protobuf/proto中的方法获取消息反射对象。

核心思路 #

旧的GetProperties返回消息字段的元信息集合，新的Protobuf反射通过**消息描述符（Descriptor）和字段描述符（FieldDescriptor）**获取这些元信息，涵盖字段名称、编号、类型、是否重复、标签选项等所有你需要的属性。

示例代码 #

1. 定义测试用Protobuf消息

syntax = "proto3";
package example;

message User {
  int32 id = 1;
  string name = 2;
  repeated string emails = 3;
  bool is_active = 4;
}

使用protoc搭配新的google.golang.org/protobuf/cmd/protoc-gen-go插件生成Go代码。

2. 反射获取字段属性的Go代码

package main

import (
	"fmt"
	"example" // 替换为你的proto生成代码包路径

	"google.golang.org/protobuf/proto"
	"google.golang.org/protobuf/reflect/protoreflect"
)

func main() {
	// 初始化测试消息
	user := &example.User{
		Id:       123,
		Name:     "Alice",
		Emails:   []string{"alice@example.com"},
		IsActive: true,
	}

	// 获取消息反射对象
	msgReflect := proto.Message(user).ProtoReflect()
	// 获取消息描述符（包含所有字段元信息）
	msgDesc := msgReflect.Descriptor()

	// 遍历所有字段描述符
	fmt.Println("消息字段属性：")
	msgDesc.Fields().Range(func(fieldDesc protoreflect.FieldDescriptor) bool {
		// 提取字段核心属性
		fieldName := string(fieldDesc.Name())
		fieldNumber := int(fieldDesc.Number())
		fieldKind := fieldDesc.Kind().String()
		isRepeated := fieldDesc.IsRepeated()
		jsonName := string(fieldDesc.JSONName())

		// 输出属性（对应原GetProperties返回内容）
		fmt.Printf("字段名：%s | 编号：%d | 类型：%s | 是否重复：%t | JSON名称：%s\n",
			fieldName, fieldNumber, fieldKind, isRepeated, jsonName)

		return true // 继续遍历下一个字段
	})
}

关键API说明 #

• proto.Message(msg).ProtoReflect()：将Protobuf消息转换为反射对象protoreflect.Message
• msgReflect.Descriptor()：获取消息描述符protoreflect.MessageDescriptor，包含所有字段元信息
• msgDesc.Fields().Range(...)：遍历所有字段描述符protoreflect.FieldDescriptor
• 字段描述符常用方法：
  • Name()：字段的Protobuf定义名称
  • Number()：字段编号
  • Kind()：字段类型（如Int32Kind、StringKind）
  • IsRepeated()：判断字段是否为重复类型
  • JSONName()：字段对应的JSON名称
  • Options()：获取字段标签选项（如默认值、验证规则等）

注意事项 #

• 确保导入google.golang.org/protobuf/proto而非旧的github.com/golang/protobuf/proto
• 新反射API可完全覆盖GetProperties的所有功能，且支持Protobuf 3新特性

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