Wire不是运行时框架，而是在编译前生成inject.go（或wire_gen.go）的代码生成工具；NewApp等函数是普通Go函数，无反射、无magic。常见报错“no injector found”主因有三：wire.go首行缺失// +build wireinject（格式须严格）、文件未置于目标包内、混入业务逻辑或未导出函数。
Wire 不是运行时框架，它在编译前就生成 inject.go（或 wire_gen.go），你调用的 NewApp、InitializeServer 全是普通 Go 函数——没 magic，没反射，没拦截，就是手写初始化代码的自动化版本。
为什么 wire build 没反应或报 no injector found
最常见原因就三个，且都和构建约束强相关：
-
wire.go第一行不是// +build wireinject（注意：前面不能有空格，不能多写逗号或其它 tag） -
wire.go不在目标包内（比如你想生成cmd/myapp/的注入器，但它被放在了项目根目录或internal/外的任意位置） - 文件里混了业务逻辑或未导出函数——
wire.go只能有 injector 声明（如func InitializeApp() *App）和wire.Build()调用，其余一律删掉
验证方式：运行 go list -f '{{.GoFiles}}' ./cmd/myapp，确认 wire.go 在输出列表中；再跑 go build -tags wireinject ./cmd/myapp，若报错找不到函数，说明构建约束失效。
wire.Build() 里漏参数或类型不匹配会怎样
Wire 不扫描全局，只认 wire.Build() 显式列出的函数。漏一个中间 provider，生成的代码直接编译失败，错误指向缺失类型的构造函数，例如：
立即学习“go语言免费学习笔记（深入）”；
./inject.go:12:9: undefined: NewRepository ./inject.go:15:11: cannot use db (type *sql.DB) as type *DB in argument to NewRepository
典型问题包括：
- 需要
*Repository，但只传了NewService，没传NewRepository和它依赖的NewDB - provider 返回
*DB（自定义别名），但依赖项声明为*sql.DB—— Wire 不做类型别名推导，必须一致 - 两个 provider 都返回
*redis.Client，Wire 直接拒绝，报multiple providers found for *redis.Client
解决方式只有两种：wire.Value 绑定具体实例，或用 wire.Struct + 字段标签区分用途。
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
provider 函数为什么不能有副作用
Wire 不执行 provider 函数体，只靠签名分析依赖图。但它生成的初始化代码会在程序启动时无条件调用这些函数。所以：
- 在
NewDB()里写db.Ping()或启 goroutine？失败就 panic，且这个 panic 发生在运行时，Wire 根本查不到 - 读配置文件、连远程服务、初始化全局状态？统统不行——这些该由上层协调，不该塞进 provider
- 返回
(*sql.DB, error)是 OK 的，Wire 会自动处理 error 并中断初始化；但如果你的函数签名没带error，而内部又可能失败，那就只能靠 panic 收场
正确姿势：provider 只负责“创建”，不负责“校验”或“启动”。健康检查、连接池预热等逻辑，放到 main() 或独立的 Setup() 函数里。
生成的 inject.go 必须提交到 Git 吗
必须。这不是缓存文件，是构建链硬依赖。
CI 流程里不跑 wire build，或本地 .gitignore 误写了 **/*.go 或 inject*，新成员拉代码后 go run main.go 就会报 undefined: InitializeApp。
建议在 CI 中加检查：
git diff --quiet || (echo "wire_gen.go out of date"; exit 1)
另外，provider 函数必须导出（首字母大写），否则 wire build 看不见；所有参数和返回值类型必须严格匹配，哪怕只是别名也不行——这点容易被忽略，尤其当团队共用基础库时，type DB *sql.DB 和 *sql.DB 在 Wire 眼里就是两种类型。
