调用reflect.Value.FieldByName遇指针值错误及Go反射问题排查

嘿，这个反射坑我之前踩过，咱们一步步拆解问题和解决办法：

错误原因 #

你遇到的这个panic，核心问题很明确：你在一个指针类型的reflect.Value上直接调用了FieldByName方法——这个方法只能作用于结构体类型的Value，指针类型直接调用就会触发错误。

看你的代码细节：Person结构体里的family字段是*Family（指针类型），当你执行v.FieldByName("family")时，拿到的是一个Kind为Ptr的Value，这时候你直接链式调用.FieldByName("last")，相当于对着指针要结构体字段，Go反射肯定会报错。

另外还有个隐藏的坑：你的所有结构体字段都是小写开头（未导出），虽然在同一个包内反射能访问，但如果后续要用validator做验证的话，未导出字段会被直接忽略，建议改成大写开头的导出字段。

解决方案 #

情况1：保留指针字段（原数据结构不变） #

我们需要先判断拿到的Value是不是指针，如果是，用Elem()方法解引用，拿到指针指向的结构体实例后再操作：

修改后的Check函数：

import (
    "fmt"
    "reflect"
)

var validate *validator.Validate
func Check(data interface{}) {
    v := reflect.ValueOf(data)
    // 如果传入的参数是指针，先解引用到结构体
    if v.Kind() == reflect.Ptr {
        v = v.Elem()
    }
    if v.Kind() == reflect.Struct {
        fmt.Println("was a struct")
        // 获取family字段的Value
        familyVal := v.FieldByName("family")
        // 检查familyVal是否为指针且非nil，是的话解引用
        if familyVal.Kind() == reflect.Ptr && !familyVal.IsNil() {
            familyVal = familyVal.Elem()
        }
        // 现在可以安全获取last字段了
        lastVal := familyVal.FieldByName("last")
        fmt.Println(lastVal.String())
    }
}

情况2：不使用指针字段（修改数据结构） #

如果可以把Person里的family改成非指针类型，那代码会简单很多，因为FieldByName拿到的直接是结构体类型的Value，不需要解引用：

修改后的数据结构（注意字段改成导出的）：

type Family struct {
    First string
    Last  string
}
type Person struct {
    Name   string
    Family Family // 去掉指针，直接用结构体实例
}

对应的简化版Check函数：

func Check(data interface{}) {
    v := reflect.ValueOf(data)
    // 处理传入参数是指针的情况
    if v.Kind() == reflect.Ptr {
        v = v.Elem()
    }
    if v.Kind() == reflect.Struct {
        fmt.Println("was a struct")
        lastVal := v.FieldByName("Family").FieldByName("Last")
        fmt.Println(lastVal.String())
    }
}

总结 #

1. 遇到这类反射错误，先检查是不是在指针类型的reflect.Value上调用了结构体专属方法（比如FieldByName），是的话用Elem()解引用即可。
2. 结构体字段尽量用大写开头导出，避免后续验证、跨包访问等问题。

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