kratos启动失败90%因初始化问题：未启mysql致connection refused、nacos/etcd超时、配置解析失败或wire注入nil；需紧盯panic前日志、启用-v参数、手动验证依赖连通性并检查error返回值。
启动报错先看日志头几行，重点盯住 panic、timeout、connection refused
Kratos 服务启动失败，90% 的 case 都卡在初始化阶段：数据库连不上、注册中心 unreachable、配置解析失败或依赖注入循环。别急着翻源码，先用 go run cmd/xxx/main.go 启动并紧盯终端输出——panic 前的那几行日志，往往直接暴露根因。
常见错误现象：
-
failed to connect to database: dial tcp 127.0.0.1:3306: connect: connection refused→ MySQL 没启，或地址/端口配错 -
context deadline exceeded出现在 registry 或 config 初始化时 → Nacos/Etcd 地址不通，或网络策略拦截 -
panic: interface conversion: interface {} is nil, not *sql.DB→ Wire 注入没成功，*sql.DB传进来的值是 nil -
invalid character '}' looking for beginning of value→configs/config.yaml格式错误，多了一个逗号或缩进错位
实操建议：
- 启动加
-v参数（如go run cmd/xxx/main.go -v）启用详细日志，Kratos 会打印每一步 ProviderSet 加载顺序 - 检查
cmd/xxx/main.go中wire.Build是否漏了某个ProviderSet，比如忘了引入data.ProviderSet - 用
telnet nacos.example.com 8848或curl -v http://etcd:2379/health手动验证下游依赖连通性
Wire 依赖注入失败导致的空指针 panic 怎么定位
Wire 是编译期注入，错误不会在运行时报，而是在 wire gen 阶段就失败；但一旦生成代码有误（比如手动改过 wire_gen.go），就会在运行时出现 nil pointer dereference，且堆栈指向 service 层，容易误判。
实操建议：
- 每次修改
internal/di/wire.go后，必须重新执行wire gen，不能靠 IDE 自动保存触发 - 检查生成的
wire_gen.go中对应函数（如NewApp）是否真的返回了非 nil 的*sql.DB或*redis.Client - 在
data.NewData函数开头加log.Printf("DB: %v", db)，确认传入参数是否为 nil；如果是，问题一定出在上层注入链 - 若用
github.com/google/wirev0.5+，开启WIRE_DEBUG=1环境变量再跑wire gen，它会输出依赖图和缺失项
配置加载失败但没报错，服务静默退出怎么办
Kratos 默认用 config.New 加载 YAML/JSON，如果文件路径错、权限不足或字段类型不匹配（比如把 port: "8000" 写成字符串，但结构体定义为 int），它可能不 panic，而是用零值继续跑，最终 HTTP server 绑定 :0 或 gRPC 监听失败，进程秒退无提示。
实操建议：
- 在
cmd/xxx/main.go中，config.New后立刻调用c.Scan(&cfg)，并检查返回 error —— 不要忽略它 - 配置结构体字段必须带
yaml:"xxx" json:"xxx"tag，且类型严格匹配；布尔值别写"true"，得写true - 用
buf lint和buf format管理 proto，避免因.proto变更未同步导致生成的v1包字段名错位，间接引发 config 解析失败 - 临时加一行
log.Printf("Loaded config: %+v", cfg)，确认关键字段（如server.http.port）是否被正确赋值
注册中心连接超时却显示“registered successfully”
这是最坑的假成功：Kratos 的 contrib/registry/nacos 或 etcd 默认 Register 方法不带重试，一次失败就返回 error；但如果你没检查这个 error，又没加日志，程序会继续往下走，看似启动成功，实则根本没注册上去，消费者查不到实例。
实操建议：
- 在
app.WithServer注册服务前，显式调用registry.Register并判断 error，例如：if err := r.Register(ctx, instance); err != nil {<br> log.Fatal("failed to register instance: ", err)<br>} - 不要依赖
app.Run自动注册逻辑；Kratos 2.8.2 仍需手动控制注册时机，尤其要确保 DB/Redis 初始化完成后再注册 - 对 Nacos/Etcd 客户端包装一层带指数退避的重试（如用
backoff.Retry），避免网络抖动导致瞬时失败 - 启动后立即 curl
http://nacos.example.com:8848/nacos/v1/ns/instance/list?serviceName=xxx，确认实例是否真实出现在服务列表里
真正难排查的不是报错本身，而是那些没报错的失败——比如配置字段类型错配、Wire 注入链断裂、注册中心静默失败。这些都不会抛 panic，但会让服务处于“活着但不可用”的状态。盯住日志第一行、检查每个 error 返回值、手动验证下游连通性，比任何 debug 技巧都管用。
