go plugin 官方不支持 windows，因 dll 模型与 go 运行时存在根本冲突；仅限 linux/macos 构建运行，需严格匹配 go 版本、goos/goarch，且须通过共享接口桥接类型，禁用 strip 符号，避免重复 open/close。
Go plugin 无法在 Windows 上使用
Go 的 plugin 包从设计上就不支持 Windows，编译时会直接报错 build constraints exclude all Go files。这不是配置问题，是官方明确不支持——因为 Windows 的动态链接模型（DLL + 导出符号机制）和 Go 运行时的类型系统、GC、goroutine 调度存在根本性冲突。
常见错误现象：import "plugin" : build constraints exclude all Go files，哪怕你用 GOOS=windows 交叉编译也不行。
- 唯一可行路径：Linux/macOS 下构建 + 运行；CI/CD 中需确保构建机与目标运行环境一致
- 别尝试绕过：改源码、打 patch、混用 CGO 或 dllloader 都不可靠，运行时大概率 panic
- 替代方案优先考虑 http 插件服务、进程间通信（如 gRPC）、或静态注册 + 接口解耦（更 Go-idiomatic）
plugin.Open 失败：undefined symbol 错误
plugin.Open 报 undefined symbol: xxx，本质是插件编译时缺失依赖符号，不是路径不对。Go plugin 不打包依赖，所有被插件引用的类型、函数、变量，必须在主程序中定义且导出（首字母大写），且编译主程序时不能加 -ldflags="-s -w"（会 strip 符号）。
使用场景：主程序提供通用日志接口、配置结构体、工具函数，插件只实现业务逻辑。
立即学习“go语言免费学习笔记（深入）”；
- 主程序中定义的
type Config Struct{...}和func Log(...)必须首字母大写，且不能放在 internal 包里 - 插件代码里不能 import 主程序的 main 包；应拆出独立的
pluginapi包，主程序和插件都 import 它 - 编译插件时必须用和主程序完全一致的 Go 版本、GOARCH、GOOS，且开启
-buildmode=plugin - 示例命令：
go build -buildmode=plugin -o auth.so ./plugins/auth
插件中调用主程序函数导致 panic: Interface conversion
插件通过 sym, _ := plug.Lookup("DoAuth") 拿到符号后，直接 sym.(func(String) Error) 强转失败，panic 报 interface is not a function。这是因为 Go 的接口底层类型检查严格：主程序和插件各自编译，即使签名相同，函数类型也被视为不同类型。
正确做法永远是通过中间接口桥接，而不是裸函数指针。
- 定义统一接口，比如
type Authenticator interface{ Auth(Token string) error }，放在共享的pluginapi包里 - 主程序实现该接口，并通过
plug.Lookup("AuthenticatorImpl")获取实例（返回interface{}），再断言为接口类型 - 插件内部不定义新函数，只实现该接口并导出为变量（不是函数）：
var AuthenticatorImpl pluginapi.Authenticator = &jwtAuth{} - 切记：插件里不能有
func main()，也不能调用os.Exit、log.Fatal等终止进程的逻辑
plugin.Close 后再次 Open 失败或内存泄漏
多次调用 plugin.Open 后又 .Close()，再 Open 同一个 so 文件，可能失败或行为异常。Go runtime 不支持重复加载/卸载同一插件，Close 并非完全卸载——它只是释放部分资源，但符号表、类型信息仍驻留内存，且某些平台（如 macOS）根本不支持 dlclose。
性能影响明显：反复 Open/Close 会累积内存占用，且类型反射缓存无法清理。
- 实践中应避免频繁热插拔；插件生命周期尽量与主程序一致
- 如果真要“重载”，必须重启整个进程（例如用 exec.Command 启动新实例，旧进程 graceful shutdown）
- 测试时可用
runtime.GC()+debug.FreeOSMemory()辅助观察，但不能解决根本问题 - 务必检查
plugin.Open返回的 error，不要忽略；Close失败通常意味着底层 OS 层已出错，继续使用该插件极可能 crash
类型安全、跨平台兼容、热更新可靠性——这三者在 Go plugin 里只能选两个。真正线上用，得把「主程序稳定」和「插件可控」当作硬约束来设计，而不是指望 runtime 替你兜底。