本文介绍在 go 项目中将主函数中初始化的客户端对象安全、清晰地注入到其他包的结构体中，避免全局变量，推荐使用构造函数显式传递依赖。
本文介绍在 go 项目中将主函数中初始化的客户端对象安全、清晰地注入到其他包的结构体中，避免全局变量，推荐使用构造函数显式传递依赖。
在 Go 的模块化开发中，常见的需求是：main 包中创建了某个服务客户端（如 my.Client），而 HTTP 处理逻辑封装在独立的 rest 包中，其处理器结构体（如 AssetHandler）需要调用该客户端的方法。此时，不能依赖全局变量或跨包直接访问 main 中的局部变量——因为 main 包无法被其他包导入，且全局状态会破坏可测试性与并发安全性。
正确的做法是：通过构造函数（Constructor Function）显式注入依赖。这符合依赖注入（DI）原则，使代码更清晰、可测试、可维护。
首先，在 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 包中完成实例化与注册：
// main.go
package main
import (
"log"
"net/http"
"your-module-path/rest" // 导入 rest 包
"your-module-path/my"
)
func main() {
// 1. 创建客户端
myClient := my.MustNewClient("localhost")
// 2. 使用构造函数创建带依赖的处理器
handler := rest.NewAssetHandler(myClient)
// 3. 注册到 HTTP 路由（注意：需传指针以支持方法集）
http.Handle("/assets", &handler) // 或 http.Handle("/assets", handler) 若 ServeHTTP 为值接收
log.Println("Server starting on :8080")
log.Fatal(http.ListenAndServe(":8080", nil))
}
⚠️ 注意事项：
-
ServeHTTP方法签名要求实现http.Handler接口；若AssetHandler方法使用值接收器（如func (h AssetHandler) ServeHTTP(...)），则http.Handle("/path", handler)可直接传值；但若后续需修改内部状态（如统计请求次数），建议改用指针接收器并传&handler。 -
my.Client类型必须在rest包中可导入（即my包已正确发布且路径可解析），确保go mod tidy无错误。 - 避免在
rest包中引入main包——这会导致循环导入，Go 编译器将报错。
✅ 总结：依赖应由上层（如 main）创建并向下传递，下层包（如 rest）只负责声明依赖、提供构造函数、使用依赖。这种模式提升了组件解耦度，便于单元测试（可传入 mock 客户端），也符合 Go 的“显式优于隐式”哲学。
