wire.gen生成失败最常见的原因是依赖链中断或类型不匹配：injector入口后每步依赖必须有provider显式提供，且返回类型须与需求完全一致（如sql.db≠database/sql.db），wire.go中混入业务逻辑或缺失//+build wireinject标签也会导致静默失败。
为什么 wire.Gen 生成失败却找不到具体原因
最常见的现象是执行 wire gen 后报错：wire: at least one generate failure 或 inject xxx: unused providerset，但错误信息不指向某一行代码。根本原因是 wire 只校验“依赖链是否完整可达”，不报语法错——它要求从 injector 函数入口开始，每一步依赖都必须有 provider 能提供，且不能中断。
- 比如你写了
ProvideDB→NewRepository→NewService→NewHandler，但漏了NewRouter（而 injector 最终要传给gin.Engine），wire 就会卡在NewHandler之后无法继续，判定为“未使用” - provider 函数返回类型必须和依赖需求**完全一致**：写
func() *sql.DB却在 injector 中需要*database/sql.DB，Go 类型系统不认为二者等价，直接报could not find provider -
wire.go文件里只允许放 injector、provider 和wire.NewSet，混入日志打印、HTTP 启动逻辑或main()会导致分析失败
如何组织 Gin 项目的依赖层级才不会被 wire 拒绝
Gin 项目天然有清晰的调用流向：data → service → handler → router → server → app。wire 要求这个链必须显式出现在 injector 的参数或返回值中，不能靠“隐式调用”补全。
- router 层必须显式接收 handler 实例（如
NewRouter(h *PostHandler)），不能只在内部 new；否则 wire 看不到 handler 到 router 的依赖传递 - server 层（如
http.Server）需由 provider 构造，且该 provider 必须把*gin.Engine作为参数传入，例如：func NewServer(e *gin.Engine, addr string) *http.Server - 避免跨包引用 provider：若
handler.NewPostHandler在handler包，但它的依赖service.IPostService的 provider 在service包，wire 默认不跨包扫描——要么把 provider 移到同一包，要么用wire.NewSet显式导入
测试环境替换依赖时为什么 MockSet 不生效
常见错误是定义了 MockSet := wire.NewSet(ProvideMockDB, NewMockService)，但在 test injector 中仍调用原 ProdSet，或者没在 wire.Build 中正确替换。
- injector 函数签名必须保持一致：测试版 injector 也得返回
*App或*gin.Engine，只是内部用的 set 不同 - 替换必须发生在
wire.Build第一个参数位置，例如：wire.Build(MockSet, NewRouter, NewServer)—— 如果写成wire.Build(ProdSet, MockSet, ...)，wire 会优先选第一个匹配的 provider，Mock 无效 - 注意循环引用：MockSet 里如果又引用了 ProdSet 中的某个 provider（比如误引入了真实 DB 初始化函数），wire 不报错但生成逻辑混乱，最终 runtime panic
Provider 函数里带 error 返回值，为什么 injector 还是编译不过
wire 支持自动传播 error，但前提是整个依赖链上所有 provider 都遵循约定：返回类型必须是 (T, error) 形式，且 T 是非指针基础类型或结构体指针。
- 错误写法：
func ProvideConfig() (config.Config, error)→ config.Config 是值类型，wire 接受；但若写成func ProvideConfig() config.Config（无 error），则一旦上游 provider 返回 error，此处就断链 - error 必须是第二个返回值，且不能是命名返回变量（如
func() (err error, db *sql.DB)不被识别） - 如果某个 provider 返回
(*sql.DB, error)，而下游依赖的是io.ReadWriter，wire 不会自动转换——接口类型必须由 provider 显式实现并返回，不能靠类型别名或嵌套推导
wire_gen.go 成功生成，运行时 DB 连接失败、Gin 路由注册顺序错乱、中间件漏挂等问题，仍需靠单元测试和启动验证来暴露。
