本文讲解如何将主包中创建的客户端实例安全、清晰地注入到其他包的结构体中，避免全局变量，遵循依赖注入原则，提升代码可测试性与可维护性。
本文讲解如何将主包中创建的客户端实例安全、清晰地注入到其他包的结构体中，避免全局变量，遵循依赖注入原则，提升代码可测试性与可维护性。
在 Go 开发中，将运行时创建的对象（如 HTTP 客户端、数据库连接、配置实例等）传递给其他包的结构体，是构建松耦合、可测试服务的关键实践。直接使用全局变量或试图从 main 包导出变量不仅违反 Go 的包可见性规则（main 包无法被其他包导入），还会导致单例滥用、难以 mock 和单元测试失败等问题。
正确的方式是通过构造函数显式注入依赖。以你的 rest 包为例，AssetHandler 需要持有 my.Client 实例才能调用其方法。为此，应在 rest 包中定义一个导出的构造函数：
// rest/handler.go
package rest
import (
"net/http"
"github.com/Sirupsen/logrus"
"your-module-path/my" // 替换为实际路径
)
type AssetHandler struct {
mc my.Client
}
// NewAssetHandler 是推荐的依赖注入入口：接收 Client 并返回初始化好的 Handler
func NewAssetHandler(mc my.Client) AssetHandler {
return AssetHandler{mc: mc}
}
func (h AssetHandler) ServeHTTP(w http.ResponseWriter, r *http.Request) {
logrus.Info("Handling asset request")
// ✅ 现在可以安全调用客户端方法
if err := h.mc.SomeFunctionIntheClient(); err != nil {
http.Error(w, "Client error", http.StatusInternalServerError)
return
}
w.WriteHeader(http.StatusOK)
}
接着，在 main.go 中完成实例化与注册：
// main.go
package main
import (
"log"
"net/http"
"your-module-path/rest" // 导入 rest 包
"your-module-path/my" // 导入 my 包
)
func main() {
// 1. 创建客户端（可能含连接池、认证等初始化逻辑）
myClient := my.MustNewClient("localhost")
// 2. 通过构造函数注入依赖，生成 handler 实例
handler := rest.NewAssetHandler(myClient)
// 3. 注册到 HTTP 路由（例如使用标准库）
http.Handle("/assets", handler)
log.Println("Server starting on :8080")
log.Fatal(http.ListenAndServe(":8080", nil))
}
✅ 关键要点总结：
-
绝不使用全局变量：Go 不支持跨包访问
main包符号，且全局状态会破坏并发安全性与测试隔离性； -
构造函数必须导出（首字母大写）：确保其他包（如
main）能调用； - 结构体字段应小写私有 + 构造函数控制初始化：保障封装性，防止外部绕过依赖直接创建未初始化实例；
-
若需复用多个 Handler（如
UserHandler、OrderHandler共享同一Client），可进一步抽象为工厂或使用依赖注入框架（如 wire）； -
注意 Client 接口设计：理想情况下，
my.Client应定义为接口（如type Client interface { SomeFunctionIntheClient() error }），便于在测试中传入 mock 实现。
这种显式依赖注入模式，不仅解决了跨包对象传递问题，更使代码职责清晰、边界明确，是 Go 工程化开发的标准实践。
