MethodByName 返回 nil 的主因是方法未导出或 reflect.Value 不可寻址；接口需先 Elem() 解包具体值；不支持嵌入方法自动查找；反射调用性能低且易 panic，应缓存 Method 并谨慎使用。
MethodByName 返回 nil 的常见原因
调用 reflect.Value.MethodByName 或 reflect.Type.MethodByName 得到 nil，通常不是方法名写错了，而是对象未导出（首字母小写）或传入的是非指针值。Go 的反射只能访问导出字段和方法，且 MethodByName 在 reflect.Value 上调用时，该值必须可寻址（即来自指针或可寻址变量），否则返回空 reflect.Value。
- 接口变量本身不包含方法实现，需先用
reflect.ValueOf(interface{}).Elem()获取底层具体值（若原值是指针） - 若原始值是值类型（非指针），
MethodByName仍可查到方法，但调用时会 panic：“call of reflect.Value.Call on zero Value”，因为无法对不可寻址的副本执行方法调用 - 正确做法：统一传入指针，再用
reflect.ValueOf(&v).Elem()得到可调用的reflect.Value
正确遍历并调用接口绑定的方法
接口变量在反射中表现为 reflect.Interface 类型，不能直接调用其方法 —— 必须先解包出底层具体类型实例。常见错误是直接对 reflect.ValueOf(myInterface) 调用 MethodByName，结果为空。
- 先用
reflect.ValueOf(i).Elem()获取接口持有的具体值（前提是该接口值由指针赋值而来） - 若不确定是否为指针，可用
reflect.ValueOf(i).Kind() == reflect.Ptr判断；更稳妥方式是用reflect.ValueOf(i).Convert(reflect.TypeOf(&struct{}{}).Type()).Elem()—— 但实际中应避免这种强行转换 - 推荐模式：定义接口时就约定实现必须是指针接收者，并始终以
&instance方式赋值给接口变量
type Greeter interface {
SayHello() string
}
type Person struct {
Name string
}
func (p *Person) SayHello() string { return "Hello, " + p.Name }
func callMethodByReflection(i interface{}) {
v := reflect.ValueOf(i)
if v.Kind() == reflect.Ptr {
v = v.Elem()
}
method := v.MethodByName("SayHello")
if !method.IsValid() {
panic("method SayHello not found or not callable")
}
result := method.Call(nil)
fmt.Println(result[0].String()) // Hello, Alice
}
MethodByName 区分大小写且不支持嵌入方法自动查找
MethodByName 是精确匹配，不会沿嵌入结构体向上查找方法，也不会忽略大小写。例如嵌入了 Logger 结构体并导出了 Log() 方法，父结构体自身没声明该方法，则 MethodByName("Log") 在父结构体的 reflect.Type 上返回 nil。
- 要获取全部可用方法（含嵌入），需遍历
reflect.Type.NumMethod()，逐个用Method(i)检查 - 嵌入字段的方法在反射中属于“提升方法（promoted methods）”，仅当嵌入字段是导出字段时才出现在
Type.Methods列表中 - 如果需要按名称模糊匹配或忽略大小写，必须自己遍历所有方法并比对
Method.Name
性能与生产环境使用提醒
反射调用方法比直接调用慢一个数量级以上，且失去编译期检查。在高频路径中避免用 MethodByName 做分发逻辑，更适合配置驱动、插件加载或调试工具等低频场景。
立即学习“go语言免费学习笔记（深入）”；
- 缓存
reflect.Method结果（如用sync.Map存map[string]reflect.Method）可减少重复查找开销 - 不要在循环内反复调用
reflect.ValueOf(x).MethodByName(name)—— 提前提取好reflect.Value和reflect.Method - 注意 panic 风险：方法签名不匹配（参数数量/类型不对）、接收者不可寻址、方法为 nil，都会导致运行时 panic
最易被忽略的一点：MethodByName 查到的是方法描述符，真正执行靠 Call()，而 Call() 的参数必须是 []reflect.Value 类型切片 —— 即使方法无参也要传 nil 或 []reflect.Value{}，漏掉这点会导致 panic。
