wire.Build漏 Provider 时编译期直接报错，因Wire仅静态分析签名构建依赖链；必须显式列出所有Provider函数，且签名严格匹配，否则生成阶段即失败。
wire.Build 里漏了 Provider 函数，编译时直接报错
Wire 不是运行时反射，它靠静态分析函数签名来拼出依赖链。一旦 wire.Build 列表里缺了某个中间依赖的 Provider，比如 NewData 没写进去，但 NewGreeterService 又依赖它，wire 就会在生成阶段报类似 "cannot find provider for *data.Data" 的错误，而不是等 kratos run 才 panic。
实操建议：
- 检查
wire.go中wire.Build调用是否包含所有必需的 Provider 函数，尤其是跨目录（如internal/data、internal/service）引入的函数，要确认 import 路径正确、函数名没拼错 - Provider 函数签名必须完全匹配：返回类型要和下游参数类型一致，比如
func() *conf.Data和func(c *conf.Data) *service.GreeterService才能连上 - 别把
func() error这类只返回错误的函数误当 Provider 加进wire.Build—— 它不提供任何实例，Wire 会忽略
忘记加 //go:build wireinject 注释，wire 命令不生效
wire 命令默认只处理带 //go:build wireinject 构建约束标记的文件。如果 wire.go 里只有 func InitializeApp() 和 wire.Build，但顶部没这行注释，wire 就会静默跳过，生成不出 wire_gen.go，后续编译自然报 "undefined: InitializeApp"。
实操建议：
- 在
wire.go文件最顶部（包声明前）加上//go:build wireinject，注意不是// +build wireinject（旧语法已弃用） - 确保该文件没有其他冲突的构建约束，比如同时存在
//go:build !wireinject会直接屏蔽掉 - 执行
wire后检查是否生成了wire_gen.go；若没生成，先grep -n "wireinject" wire.go确认注释存在且位置正确
Provider 返回 error 但没被 handle，导致注入失败
Wire 允许 Provider 返回 (T, error)，但它要求你显式处理这个 error —— 不能只写 func() (*sql.DB, error) 就完事。如果下游 Injector 函数签名没声明接收 error，或者你用了 wire.Value/wire.InterfaceSet 却没配好 error 处理逻辑，wire 会报 "provider returns error but no error handler defined" 类错误。
实操建议：
- 对可能失败的初始化（如数据库连接、配置加载），Provider 必须返回
(T, error)，且 Injector 函数签名也要带error参数，例如func(newApp(*conf.Data) (*kratos.App, error)) - 避免在 Provider 内部直接
log.Fatal或os.Exit—— 这会让 Wire 无法捕获错误并统一处理 - 如果想让某个 Provider 失败时整个启动失败（而非继续尝试），就别用
wire.Optional，保持 error 透传到 Injector 层
wire_gen.go 编译失败，常见于 Go 版本或依赖版本不匹配
wire_gen.go 是生成代码，它依赖当前项目中所有 Provider 的实际类型定义。如果你升级了 github.com/go-kratos/kratos/v2 或 google.golang.org/grpc，但没同步更新 go.mod 里的其它关联模块（比如 protoc-gen-go、google.golang.org/protobuf），生成的代码里可能出现类型不兼容，比如 grpc.Server 和 grpc_v1.Server 冲突，编译报 "cannot use gs (type *grpc.Server) as type *grpc_v1.Server"。
实操建议：
- 每次升级 Kratos 主版本后，先跑
go mod tidy，再手动检查go list -m all | grep -E "(grpc|protobuf|kratos)"，确认大版本对齐（如 grpc v1.6x、protobuf v1.33x、kratos v2.12.x） - 删掉
wire_gen.go，重新执行wire；不要手动改它 —— 它是纯生成物 - 如果
wire本身报错说找不到某些符号，大概率是go.mod里有 replace 或本地路径引用，先清理掉再试
Wire 生成的代码看似“多了一层”，但真正容易被忽略的是：它把所有依赖关系的合法性检查压到了 go build 阶段。只要 wire_gen.go 能编译过，90% 的初始化顺序、参数传递、类型匹配问题就已经被拦住了 —— 这个边界感，比手写 new 链更硬，也更不容绕过。
