Wire 在 Kratos 中是默认依赖注入机制，其三大刚性约定为：provider 必须返回具体类型而非 interface；injector 函数需带 //+build wireinject 标签；wire gen 必须在 injector 所在包路径下执行。
wire 在 Kratos 中不是可选项，而是默认依赖注入机制。它不靠反射、不 runtime 查类型，而是在生成阶段就把初始化链写死——这意味着：只要 wire gen 能过，你的依赖树大概率不会在启动时报错。
但很多人卡在“写了 provider 却没生效”“wire.Build 里漏了某个函数”“生成后 panic 找不到实例”，根本原因往往不是 wire 不会用，而是没理清它的三个刚性约定。
provider 函数必须返回具体类型，不能是 interface
Wire 的 provider 是普通 Go 函数，但它有硬约束：返回值类型必须是 concrete type（比如 *Database），不能是 DBInterface。interface 只能出现在 injector 的参数或返回值中，不能作为 provider 的返回类型。
常见错误现象：
-
wire gen报错no provider found for ... - 生成的
wire_gen.go里没出现你期望的变量初始化代码
正确写法示例：
func NewDatabase() *Database {
return &Database{Host: "localhost", Port: 5432}
}
<p>// ✅ 正确：provider 返回 *Database
// ❌ 错误：func NewDB() DBInterface { ... } —— wire 无法推导实现类
如果你需要绑定 interface，得用 wire.Bind 配合 wire.InterfaceValue 或显式构造函数，不能只靠返回 interface 的 provider。
injector 必须带 //+build wireinject 标签
Wire 只扫描带 //+build wireinject 构建标签的文件和函数。漏掉这行注释，wire gen 就完全看不到你的 InitializeApp 函数，自然什么也不生成。
典型错误场景：
- 把 injector 放在
main.go里，但没加构建标签 - 用 IDE 自动生成了函数，忘了补注释
- 复制了别人代码，但没注意注释被删了
标准 injector 模板：
//+build wireinject
package main
<p>import "github.com/google/wire"</p><p>func InitializeApp() (*App, error) {
wire.Build(NewDatabase, NewGreeter, NewApp)
return nil, nil
}
注意：return nil, nil 是占位写法，wire 会覆盖整个函数体；但函数签名必须匹配，且不能有其他逻辑。
wire gen 命令必须在包含 injector 的包路径下执行
Wire 不会跨 module 或跨目录自动递归查找 injector。你在项目根目录执行 wire gen，但它实际只扫描当前工作目录下的 ./... 包 —— 如果你的 wire.go 在 internal/wire 下，就必须先进入该目录再运行命令。
常见坑点：
- 在项目根目录跑
wire gen，但 injector 在cmd/app/wire.go→ 无输出、无报错、无生成 - 用 Makefile 封装
wire gen，但未指定-cwd或 cd 到对应目录 → 生成空文件或失败 - Kratos layout 默认把 injector 放在
cmd/server/wire.go，别直接在项目根目录敲命令
推荐做法：
cd cmd/server && wire gen
生成后会产出 wire_gen.go，它和 injector 文件在同一目录，且会被 Go 编译器正常识别（因为没有构建标签）。
kratos.New() 的参数顺序和类型必须与 injector 返回值严格一致
Kratos 的 kratos.New() 接收的是 *App，而这个 *App 必须由 injector 函数返回。如果 injector 写成 func InitializeApp() (App, error)（少了个 *），或者返回了 *kratos.App 但 import 路径不对，wire gen 虽然可能成功，但运行时会 panic：cannot use app (type *"github.com/go-kratos/kratos/v2".App) as type *"your-project/cmd/server".App。
关键检查点：
- injector 返回的
*App类型定义是否在当前包？还是从 kratos 直接 import？→ 必须是你自己定义的type App struct { ... } -
kratos.New()调用是否传入了 injector 生成的*App实例？不是手动 new 的 - 所有 provider 参数类型是否能在 injector 签名中被完整推导？比如
NewGreeter(*Database)依赖*Database，那NewDatabase就必须出现在wire.Build列表里
最常被忽略的一点：Kratos 的 newApp 函数（如模板里的 func newApp(...)*kratos.App）只是个普通工厂函数，它不参与 wire 依赖图。wire 只管从 injector 开始、按 wire.Build 列表一层层解析构造函数调用链 —— 所以别指望把 newApp 塞进 wire.Build 就能自动连上 kratos.App。
