Go Plugin 变量初始化：通过共享 store 包实现延迟依赖注入-Golang-PHP中文网

Go Plugin 变量初始化：通过共享 store 包实现延迟依赖注入

本文介绍如何在 Go Plugin 场景下解耦插件对具体实现的依赖，利用共享 store 包提前注册工厂函数，使插件内变量可在包级初始化阶段（var 声明或 init()）安全调用，无需手动逐层 Init() 调用。

本文介绍如何在 go plugin 场景下解耦插件对具体实现的依赖，利用共享 `store` 包提前注册工厂函数，使插件内变量可在包级初始化阶段（`var` 声明或 `init()`）安全调用，无需手动逐层 `init()` 调用。

在 Go 插件（plugin）开发中，一个常见痛点是：插件无法在编译时直接依赖主程序中的具体实现（如 logger.CreateLogger），但又希望复用主程序已有的初始化逻辑（例如在 var dlog = logger.CreateLogger("mypackage") 中完成日志器实例化）。由于插件的 init() 函数在 plugin.Open() 时即执行，而此时主程序尚未完成依赖注入，传统方式往往被迫改写为显式 Init(f) 函数链，破坏了原包的自然初始化语义。

更优雅的解决方案是引入一个轻量、无实现、仅含接口与全局变量的共享 store 包——它作为主程序与插件之间的“契约桥梁”，不引入运行时依赖，仅承载可变的工厂函数或预创建实例。

✅ 实现步骤

定义统一接口（独立包）
将 Logger 接口抽离至公共包（如 mylogger），确保主程序与插件引用完全一致的类型：
```
// mylogger/logger.go
package mylogger

type Logger interface {
    Log(msg string)
}
```

创建 store 包（主程序与插件共用）
该包仅含一个导出的工厂函数变量，无任何实现逻辑，体积极小且零依赖：

// store/store.go
package store

import "mylogger"

// LoggerFactory 是主程序在加载插件前必须设置的工厂函数
var LoggerFactory func(name string) mylogger.Logger

主程序：提前注册，再加载插件
在调用 plugin.Open() 之前，向 store 注入实际工厂函数（如 logger.CreateLogger）：

// main.go
package main

import (
    "fmt"
    "plugin"
    "store"
    "mylogger"
    _ "logger" // 确保 logger 包初始化（若需）
)

func main() {
    // ✅ 关键：在 Open 前设置 factory
    store.LoggerFactory = logger.CreateLogger

    // 此时再打开插件，其内部 var 初始化即可安全调用 store.LoggerFactory
    p, err := plugin.Open("./mypackage.so")
    if err != nil {
        panic(err)
    }

    sym, _ := p.Lookup("DoWork")
    doWork := sym.(func())
    doWork()
}

插件代码：按原习惯初始化
mypackage 直接使用 store.LoggerFactory 进行包级变量初始化，完全保留原有结构和 init() 语义：

// mypackage/main.go（插件入口）
package main

import (
    "mypackage"
    "plugin"
)

// Exported symbol for main program to call
func DoWork() {
    mypackage.DoSomething()
}

// mypackage/mypackage.go
package mypackage

import (
    "fmt"
    "mylogger"
    "store"
)

// ✅ 自然初始化：dlog 在 plugin.Open 时即被赋值
var dlog = store.LoggerFactory("mypackage")

func init() {
    // 此处可安全使用 dlog，因 store.LoggerFactory 已由主程序设置
    dlog.Log("mypackage initialized")
}

func DoSomething() {
    dlog.Log("doing work...")
}

⚠️ 注意事项

store 必须被主程序与插件同时 import，确保链接到同一内存地址的变量；建议将其置于独立模块（如 github.com/yourorg/store），避免路径歧义。
初始化顺序不可颠倒：store.LoggerFactory = ... 必须在 plugin.Open() 之前执行，否则插件 init() 中访问将 panic（nil function call）。
线程安全：若主程序多 goroutine 并发加载插件，需加锁保护 store.LoggerFactory 赋值（通常单次初始化，故非必需）。
类型一致性：主程序传入的 logger.CreateLogger 返回类型必须严格实现 mylogger.Logger，否则编译或运行时报错。

✅ 总结

相比手动 Init() 链式调用，store 模式以极小侵入性恢复了 Go 原生的包初始化能力：变量声明即初始化、init() 语义完整、插件代码零改造。它本质是一种静态依赖注入（Compile-time DI），不依赖第三方框架（如 facebookgo/inject），不增加运行时开销，完美契合 Go Plugin 的约束场景。只要主程序与插件共享一个纯净的 store 包，即可实现清晰、可靠、可维护的插件初始化架构。