本文讲解如何通过构造函数将主包中创建的客户端对象安全、清晰地注入到其他包的处理器结构体中，避免使用全局变量，符合 go 的依赖注入最佳实践。
本文讲解如何通过构造函数将主包中创建的客户端对象安全、清晰地注入到其他包的处理器结构体中，避免使用全局变量，符合 go 的依赖注入最佳实践。
在 Go 开发中，跨包共享状态（如 HTTP 客户端、数据库连接、配置等）是一个常见需求。但直接使用全局变量不仅破坏封装性、降低可测试性，还可能导致并发安全隐患和初始化顺序问题。正确的做法是显式传递依赖——即通过构造函数（constructor）将外部对象注入目标结构体。
以你的场景为例：main 包中创建了 myClient，而 rest 包中的 AssetHandler 需要使用它。关键在于：rest 包不应自行创建或查找该客户端，而应由调用方（即 main）负责提供。
✅ 正确实现方式：依赖注入 via Constructor
首先，在 rest 包中定义一个导出的构造函数：
// rest/handler.go
package rest
import (
"net/http"
"github.com/Sirupsen/logrus"
"your-module-path/my" // 替换为实际路径
)
type AssetHandler struct {
mc my.Client
}
// NewAssetHandler 是推荐的依赖注入入口点
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 (
"net/http"
"your-module-path/rest" // 替换为实际路径
"your-module-path/my"
)
func main() {
myClient := my.MustNewClient("localhost")
// ✅ 通过构造函数注入依赖
handler := rest.NewAssetHandler(myClient)
// 注册到 HTTP 路由器（例如标准库）
http.Handle("/assets", handler)
log.Println("Server starting on :8080")
http.ListenAndServe(":8080", nil)
}⚠️ 注意事项与最佳实践
-
结构体字段命名：建议将
mc改为更具语义的名称（如client），并保持首字母小写以限制包外访问（client my.Client）； -
接收者类型选择：若
ServeHTTP会修改AssetHandler内部状态（如缓存、计数器），应使用指针接收者func (h *AssetHandler) ServeHTTP(...)；当前示例为值接收者，适用于只读使用； -
错误处理：示例中补充了
SomeFunctionIntheClient()的错误检查，生产环境务必处理返回错误； -
避免循环导入：确保
rest包未反向导入main，且my包路径正确（Go 模块路径需完整、唯一）； -
扩展性考虑：未来如需注入多个依赖（如 logger、config），可统一使用配置结构体（如
Config{Client: ..., Logger: ...}）简化构造函数签名。
这种显式依赖注入方式使代码更易单元测试（可传入 mock 客户端）、更易维护，并完全遵循 Go “explicit is better than implicit” 的设计哲学。
