插件函数必须首字母大写，否则reflect.value.call会panic；所有被反射调用的函数、方法需导出，第三方私有函数须封装导出桥接；调用前须校验参数个数与类型，统一签名如func(context.context,map[string]interface{})error；plugin.symbol返回interface{}需经reflect.value.interface()中转再断言；插件不可引用主程序内部包；高频调用须缓存reflect.value；热替换需手动切换缓存；应使用recover捕获并记录panic详情。
插件函数必须首字母大写，否则 reflect.Value.Call 会 panic
Go 反射无法访问未导出符号，这是编译器层面的限制，不是运行时权限问题。当你用 plugin.Lookup 拿到一个 symbol，再用 reflect.ValueOf(sym).Call() 调用时，如果底层函数是小写开头（如 handleEvent），会立即 panic，错误信息类似 call of reflect.Value.Call on unexported method。
- 插件代码里所有要被反射调用的函数或方法，必须首字母大写，例如
HandleEvent、Init、Execute - 第三方包里的私有函数无法直接调用，只能封装一层导出函数桥接：
func Wrapper() { thirdparty.handleEvent() } - 结构体方法同理：接收者为指针时，确保传入的是
*Struct类型的reflect.Value，否则MethodByName返回无效值
调用前必须校验 NumIn 和 In(i).Kind()，不能依赖配置字符串
反射不检查参数类型，传错类型或数量不对，会在 Call 时才 panic，错误信息通常是 reflect: Call with too few or too many input arguments 或更模糊的 Call using zero Value。插件系统若靠 JSON/YAML 配置传参，极易踩坑。
- 统一约定插件函数签名，例如
func(context.Context, map[string]interface{}) error，注册时用reflect.TypeOf(fn).NumIn()校验参数个数 - 逐个检查
reflect.TypeOf(fn).In(i).Kind()，比如确认第一个参数确实是reflect.Chan或reflect.Ptr，而不是误传reflect.Struct - 避免把原始值直接塞进
reflect.ValueOf(42)：目标期望int64，你就得先转成int64(42)再包装 -
context.Context建议固定为第一个参数，便于主程序统一注入超时控制，也方便后续加中间件逻辑
plugin.Symbol 返回的是 interface{}，必须经 reflect.Value.Interface() 中转再断言
直接写 sym.(PluginInterface) 会失败——即使插件和主程序定义了完全相同的接口，因包路径不同（如 main.PluginInterface vs plugin.PluginInterface），类型不等价。这是 Go 插件 ABI 的硬性限制。
- 正确做法：先用
v := reflect.ValueOf(sym)，再调v.Interface()得到“去类型化”的原始值，最后做断言：p, ok := v.Interface().(PluginInterface) - 跳过
Interface()直接断言，panic 信息常为interface conversion: interface {} is not xxx: missing method YYY - 插件中不能引用主程序的内部包（如
main/utils），否则plugin.Open会失败，报undefined symbol: main.(*Config).Validate - 跨平台兼容需求强的场景，可放弃
plugin包，改用注册表 +init()注册 +reflect.Value.MethodByName调用
高频调用必须缓存 reflect.Value，否则性能断崖式下跌
reflect.ValueOf(fn) 和 reflect.Value.MethodByName 是昂贵操作，内部涉及类型查找、内存拷贝和安全检查。在插件热加载后每秒调用数百次的场景下，不缓存会导致 CPU 占用飙升。
- 首次加载插件后，把
reflect.Value缓存到 map 中，key 可以是插件名 + 方法名组合 - 不要每次调用都重新
reflect.ValueOf(obj).MethodByName("Do")，而应复用已缓存的reflect.Value - 若插件支持热替换，旧缓存需显式清理，但注意：Go plugin 不支持卸载，所谓“热替换”本质是新插件加载成功后，通知旧插件 graceful shutdown，再切换缓存引用
- 对延迟敏感的系统，可考虑用
reflect.MakeFunc预生成闭包，绕过重复的反射开销，但会增加内存占用
recover() 和详细的 panic 日志，比写一百行校验逻辑都管用。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
