本文讲解如何通过构造函数将主包中创建的客户端对象传递给其他包的结构体，避免使用全局变量，实现松耦合、可测试的依赖注入设计。
本文讲解如何通过构造函数将主包中创建的客户端对象传递给其他包的结构体，避免使用全局变量，实现松耦合、可测试的依赖注入设计。
在 Go 语言中，跨包共享运行时对象（如 HTTP 客户端、数据库连接等）不应依赖全局变量或包级变量——这会破坏封装性、阻碍单元测试，并导致隐式依赖。推荐做法是采用显式依赖注入：在目标包中定义构造函数，接收所需依赖作为参数，并返回已初始化的结构体实例。
以你的 rest 包为例，AssetHandler 需要使用 my.Client，但该类型在 main 包中创建。正确做法是为 AssetHandler 提供一个导出的构造函数：
// rest/handler.go
package rest
import (
"net/http"
"github.com/Sirupsen/logrus"
"your-module-path/my" // 替换为实际路径
)
type AssetHandler struct {
mc my.Client
}
// NewAssetHandler 是依赖注入的入口：显式接收 client 实例
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)
http.ListenAndServe(":8080", nil)
}⚠️ 注意事项：
-
my.Client类型必须在rest包中可导入（即my包已正确导出且路径正确）； - 构造函数名
NewAssetHandler首字母大写，确保其在包外可访问； - 若
AssetHandler后续需修改内部状态（如设置超时、日志器等），建议改用指针接收器并返回*AssetHandler，便于扩展； - 避免在
rest包内直接import "main"—— Go 不允许循环导入，且main包不可被其他包导入。
这种模式不仅解决了跨包对象传递问题，还提升了代码的可维护性与可测试性：你可以在测试中轻松传入 mock 客户端，无需启动真实服务。
