Golang反射递归解析嵌套结构体指针字段触发零值panic问题

运行触发panic: reflect: call of reflect.Value.NumField on zero Value的核心原因有两点：

• 未校验指针是否为nil：Protobuf生成的结构体中大量字段为指针类型，结构体初始化时这类指针默认是nil零值，直接对nil指针做解引用拿到的是无效的反射Value，后续调用NumField()方法就会触发panic
• 未校验值类型：指针指向的目标不一定是结构体，也可能是string、int64这类基础标量类型，对非结构体类型调用NumField()本身就是非法操作。
  原代码中注释掉的指针判断逻辑没有覆盖nil校验和类型校验，递归到非结构体的nil指针字段时就会崩溃。

在递归逻辑中补充三层校验即可解决问题：

• 入口处先校验反射Value的有效性，无效值直接终止递归
• 遇到指针类型时循环解引用，遇到nil指针直接终止递归
• 解引用完成后判断值类型，只有结构体类型才继续遍历字段，非结构体直接返回

修复后的可运行代码如下：

package main

import (
	"fmt"
	"reflect"
)

func getFields(protoStructure interface{}) {
	val := reflect.ValueOf(protoStructure)
	// 跳过无效反射值
	if !val.IsValid() {
		return
	}

	// 循环解引用所有指针层级，遇到nil直接返回
	for val.Kind() == reflect.Ptr {
		if val.IsNil() {
			return
		}
		val = val.Elem()
	}

	// 非结构体类型不需要遍历字段，直接返回
	if val.Kind() != reflect.Struct {
		return
	}

	fieldCount := val.NumField()
	for i := 0; i < fieldCount; i++ {
		fieldVal := val.Field(i)
		fieldMeta := val.Type().Field(i)
		// 打印字段名和description标签
		fmt.Println(fieldMeta.Name, fieldMeta.Tag.Get("description"))
		// 递归处理指针、结构体类型字段
		if fieldVal.Kind() == reflect.Ptr || fieldVal.Kind() == reflect.Struct {
			getFields(fieldVal.Interface())
		}
	}
}

// 测试用Protobuf风格结构体
type DeviceInfo struct {
	OS  *string `description:"操作系统类型"`
	Ver *string `description:"系统版本号"`
}
type DeviceEnv struct {
	DeviceID *string     `description:"设备唯一标识"`
	Info     *DeviceInfo `description:"设备硬件信息"`
	Platform int32       `description:"所属平台枚举"`
}

func main() {
	getFields(&DeviceEnv{})
}

• 修复后的代码会自动跳过nil指针字段，不会触发零值反射panic
• 自动识别标量类型指针（如*string、*int32），不会对这类非结构体字段尝试遍历
• 支持多层嵌套结构体、多级指针场景，完全适配Protobuf生成代码的字段特性

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