go微服务依赖注入本质是构造函数注入+接口抽象+显式初始化；应手写newxxx函数并在main.go中清晰串联db→cache→service→server链，避免dig等运行时框架导致隐式依赖和调试困难。
Go 微服务里没有“依赖注入框架”这回事，所谓方案差异，本质是你愿不愿意把构造逻辑交给工具生成——手动写 NewUserService 是默认且最稳的路，wire 只在重复五遍以上初始化链时才值得引入，dig 或 Fx 在主干依赖中会埋下隐式、难调试、静态分析失效的坑。
构造函数参数必须全是接口，否则不算依赖注入
常见错误现象：NewUserService(db *sql.DB) 看似简洁，实则绑死实现；测试时无法传入 fakeDB，运行时 db 为 nil 导致 panic 堆栈指向 GetUser 而非构造处。
-
UserRepo接口必须由调用方（如service包）定义，不能由repo包“顺手导出”一个带UpdateEmailTx的大接口 - 接口方法签名要窄：
GetUser(ctx, id)✅，GetUserBySQL(ctx, sql, args)❌——后者把 SQL 细节暴露给上层，破坏抽象 - 结构体字段类型必须是接口：
db UserRepo✅，db *sql.DB❌；否则 IDE 跳转失效、go vet检不出漏传 - 构造函数内应校验
nil：if db == nil { panic("db is required") }，避免延迟到业务调用时崩
wire.Build 报 “could not find provider for *xxx.Service” 怎么查
这不是 provider 函数缺失，而是 wire 在解析依赖链时卡在中间类型。错误提示永远指向下游缺依赖，根源却在上游漏了某个 provider。
-
wire.go第一行必须是//+build wireinject，独占一行、前面不能有空格、后面不能加逗号或注释——漏了或格式错，整个文件被静默跳过 -
wire.go必须和目标包同级：你要生成cmd/myapp/InitializeApp()，它就得放在cmd/myapp/目录下，不能扔在根目录或internal/ -
wire.Build(InitializeApp, NewService, NewRepository)漏了NewDB？编译报错永远说NewService缺*Repository，但真正缺的是NewRepository自己依赖的*sql.DB - provider 函数（如
ProvideDB）必须在同一包内，且返回值类型严格匹配：*sql.DB≠database/sql.DB≠driver.Conn
同类型多实例（如主从 DB）怎么避免 wire panic
wire 对类型严格匹配，两个函数都返回 *sql.DB 就会 panic：multiple providers found for *sql.DB。它不看函数名，只认签名。
- 别试图靠命名绕过：
NewPrimaryDB()和NewReplicaDB()没用，wire不解析函数名 - 正确做法只有两种：
wire.Value(primaryDB)和wire.Value(replicaDB)注入已创建的实例（适合配置驱动流程） - 或用
wire.Struct(new(App), "primaryDB", "replicaDB")，前提是App结构体字段名明确、导出、类型一致 - 类型冲突总在生成阶段报错，但根源是设计时没提前规划好字段契约或命名空间
main.go 就是依赖组装图的源代码，别藏起来
微服务启动顺序敏感（DB 必须早于 Service），这个顺序就该写死在 main() 里，而不是藏进 wire.Build 或容器配置。
- 先初始化最底层依赖：
logger、config、*sql.DB、redis.Client - 再逐层
New上层：repo := NewUserRepo(db)→svc := NewUserService(repo, cache, logger) - 最后把
svc注入 HTTP handler 或 gRPC server：http.Handle("/user", &UserHandler{svc: svc}) - 绝不允许在 handler 内部
newservice，否则测试时无法注入 fake - 如果某层
New返回error，上层能立刻处理；而运行时 DI 框架（如dig）往往等到fx.New()才 panic，堆栈难定位
复杂点不在工具选型，而在接口定义是否窄、字段是否全为接口、main.go 是否真能一眼看清整条链——这些地方一松动，加再多 wire 或换再“高级”的容器也救不回来。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
