反射调用函数前必须确保函数可导出，因Go反射无法访问未导出函数，否则会panic；插件函数需首字母大写，第三方私有函数须封装导出；调用前应预检Kind和CanInterface，并校验签名与参数类型；plugin不支持卸载，需替换式加载并统一生命周期管理；高频调用需缓存reflect.Value以降低性能开销。
反射调用函数前必须确保函数可导出
Go 的反射机制无法访问未导出（小写开头）的函数，reflect.Value.Call 在尝试调用私有函数时会 panic 并报错 call of reflect.Value.Call on unexported method。这不是权限问题，而是 Go 编译器在生成反射信息时就过滤掉了非导出符号。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 插件函数必须定义为导出函数（首字母大写），例如
func HandleEvent()，不能是func handleEvent() - 如果函数来自第三方包且不可改源码，只能通过封装一层导出函数来桥接，比如：
func Wrapper() { thirdparty.handleEvent() } - 加载插件前可用
reflect.Value.Kind() == reflect.Func和reflect.Value.CanInterface()做预检，避免运行时报错
动态加载插件时需统一函数签名与参数类型检查
反射调用不校验参数类型，传错类型或数量不足会导致 panic，错误信息通常是 reflect: Call using zero Value 或 reflect: Call with too few or too many input arguments。热插拔系统若允许不同插件实现不同签名，必须在调用前做显式校验。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 约定插件函数签名，例如统一为
func(context.Context, map[string]interface{}) error，并在注册时用reflect.TypeOf(fn).NumIn()和.In(i).Kind()校验 - 避免直接传原始值：
reflect.ValueOf(42)是int，但目标函数期望int64就会失败；应提前转换为对应类型再reflect.ValueOf() - context 参数建议固定为第一个参数，便于统一注入超时/取消逻辑，也利于后续中间件扩展
插件热加载后无法卸载，需靠进程级生命周期管理
Go 不支持从内存中卸载已加载的 *plugin.Plugin 或其符号，plugin.Open() 加载的 so 文件句柄虽可 Close()，但已注册的函数指针、全局变量、goroutine 仍驻留内存，再次 Open() 同一路径会报错 plugin: symbol not found 或引发竞态。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 热插拔 ≠ 热卸载；实际做法是“替换式加载”：新版本插件加载成功后，通知旧插件 graceful shutdown（如关闭内部 channel、等待 goroutine 退出），再丢弃旧句柄
- 避免在插件里启动长期 goroutine 或注册全局回调（如
http.HandleFunc），否则无法清理；应由宿主程序统一管理生命周期 - 调试时注意
plugin.Open()要求 so 文件用go build -buildmode=plugin编译，且 GOOS/GOARCH 必须与宿主完全一致，否则报错plugin was built with a different version of package
反射调用性能开销明显，高频场景需缓存 reflect.Value
每次调用 reflect.ValueOf(fn) 都会重新构建反射对象，而 reflect.Value.Call 比直接调用慢 10–100 倍。插件被频繁触发（如 HTTP 中间件、消息路由）时，这部分开销会放大。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 在插件注册阶段就缓存
reflect.Value，而不是每次调用都reflect.ValueOf(fn)；例如用map[string]reflect.Value存储已加载函数 - 若插件函数签名固定，可进一步用
reflect.MakeFunc生成一次适配后的闭包，把反射调用转为普通调用（但会增加内存占用） - 压测时重点对比
reflect.Value.Call和直接调用的 p99 延迟，尤其在并发 >1k 场景下，差异会更显著
真正难的不是让插件跑起来，而是让它们能安全地共存、有序地交接、以及在 panic 时不拖垮主程序——这些都要靠宿主对插件行为的约束和兜底，而不是依赖反射本身。
