Kratos服务“启动不报错、调用就panic”主因是Wire注入失败导致service/dao字段为nil,根源在于Provider返回(nil, err)未panic、Proto字段变更后wire未同步、Context透传缺失或错误码契约不匹配。

Kratos 微服务一报错就卡在日志末尾、没堆栈、不崩溃也不响应?八成不是业务逻辑问题,而是框架层初始化或契约错位导致的静默失败。
Wire 注入失败导致 service 字段为 nil
最典型的“启动不报错、调用就 panic”现象,根源是 Wire 生成的依赖注入代码把 nil 赋给了 service 或 dao 字段。Kratos 不校验注入结果,直到你调用 s.dao.GetUser() 才炸开。
- 检查所有
NewDAO()、NewData()、NewRepo()函数:必须对返回的error显式panic(err),不能只返回(nil, err) - 重点盯
sql.Open、redis.NewClient、grpc.Dial这类初始化调用——配置缺失时它们常返回(nil, err) - 在
main.go的InitApp()前后加日志,打印app和关键模块指针值,确认非nil - 运行
go vet -tags=wire可提前发现部分绑定字段名不匹配(比如 proto 改了字段但wire.go没更新)
Proto 变更后 wire 绑定失效
改了 .proto 文件(如重命名字段、删 service 方法),再跑 go generate ./,pb.go 更新了,但 wire.go 还按旧结构注入,导致 struct 字段保持零值。
- 每次
go generate ./后,手动核对wire.go中的Bind或Struct声明是否与新pb.go中的 struct 字段完全一致 - 特别注意嵌套类型:比如
user.User改成user.UserInfo,wire.go里若还写user.User就会注入失败 - 错误现象:日志无异常,但 handler 里访问
req.GetUser().Name时 panic —— 因为req是空 struct,字段全零值
中间件里 ctx.Value() 返回 nil 导致解引用 panic
自定义中间件中写 v := ctx.Value(key); u := v.(*User),结果一运行就 crash。这不是 Kratos bug,而是 context 透传没做对。
- Kratos 的 HTTP 中间件接收的是
*http.Request的 context,你往全局 context 或transport.HTTPContext()塞的值不会自动出现 - 前置中间件必须显式注入:
r = r.WithContext(context.WithValue(r.Context(), key, val)),再调next.ServeHTTP(w, r) - 别用
transport.HTTPContext(r)—— 它返回空 context;也别用transport.HTTPRequestContext(r)—— 它含 transport info,但不含你的业务数据 - 如果要用
ctx.Value(),建议统一走metadata.Metadata,避免跨 transport 丢失
错误码未按规范定义导致 HTTP 状态码始终 500
明明返回了 errors.NotFound(),curl 却看到 Status: 500,前端收不到 404。问题出在错误契约没对齐。
- 错误码必须定义在服务自己的
.proto文件里,enum 名推荐ErrorReason,且每个值必须带(errors.code) = NNN注解,例如USER_NOT_FOUND = 0 [(errors.code) = 404]; - handler 中必须用
errors.NotFound(ErrUserNotFound, "xxx")封装返回,禁止errors.New("xxx")或裸fmt.Errorf - 验证方式:直接
curl -v看响应头Status,不是看日志或 response body - 如果始终是 500,先检查 proto 是否漏了
(errors.code),再确认返回 error 是否来自errors.Xxx()封装函数
真正难排查的从来不是 panic 堆栈,而是那些不报错、不崩溃、只是字段为 nil 或 context 为空的“静默失效”——它们藏在 Wire、Proto、Context、Errors 四个契约点上,每个点差一行代码,服务就变成黑盒。


















