Kratos启动失败主因是wire注入链断裂：internal/server/server.go未注册service实例、main.go未调用wire.Build组合依赖，或module名与路径不一致。
Kratos 不是“选了就能跑通”的玩具框架，它默认就要求你按协议驱动、分层解耦、依赖注入三件套来组织代码。跳过这些约束强行“快速上手”，后面 80% 的报错都源于结构不合规。
kratos new 生成的项目为什么启动失败？
常见错误现象：panic: interface conversion: interface {} is nil, not *service.GreeterService 或 failed to initialize wire: no buildable Go source files。
根本原因不是代码写错了，而是 wire 注入链断裂——internal/server/server.go 里没把 service 实例注册进 ProviderSet，或者 cmd/server/main.go 没调用 wire.Build 正确组合所有依赖。
- 检查
internal/service/greeter_service.go是否实现了service.GreeterServer接口（注意不是pb.GreeterServer） - 确认
internal/server/server.go的ProviderSet包含了service.NewGreeterService -
cmd/server/main.go中wire.Build必须显式包含server.ProviderSet和service.ProviderSet，缺一不可 - 别手动删
go.mod后只跑go init—— Kratos v2.7+ 要求 module 名必须和cmd/server/main.go所在路径一致，否则wire找不到包
proto 文件改了，为什么 gRPC client 调不通？
不是 protoc 没装好，也不是生成命令漏了，而是 Kratos 强制要求 HTTP 和 gRPC 接口共用同一份 .proto 定义，并通过 option (google.api.http) 注解绑定路径。漏掉注解或路径冲突，就会出现 404 或 UNIMPLEMENTED 错误。
立即学习“go语言免费学习笔记（深入）”；
- HTTP 路由必须写在
service块内，且每个 RPC 方法都要有对应get/post注解，例如：option (google.api.http) = {get: "/helloworld/{name}"}; - gRPC 方法名首字母必须大写（
SayHello），但 HTTP 路径里的变量名要小写（{name}），大小写不匹配会导致参数绑定失败 - 修改 proto 后必须重新运行
kratos proto client和kratos proto server，不能只跑其中一个 - 如果用了自定义
layout.yaml，确认其中proto_dir指向的是api/而非api/helloworld/，否则生成器找不到文件
服务注册不上 Consul/Etcd，日志里没报错怎么办？
Kratos 的服务发现默认是“静默启用”：只要配置里写了 discovery 地址，它就自动注册，但不校验连通性。注册失败时只打 info 日志，容易被忽略。
- 检查
configs/config.yaml中discovery配置是否在server:下一级，而不是平级；正确位置是：server: discovery: "consul://127.0.0.1:8500" - Consul 需要开启
acl = false或配好 token；Etcd 要确认endpoints是数组格式，不是字符串 - 用
curl http://127.0.0.1:8500/v1/health/service/<service-name></service-name>直接查 Consul API，看返回是否为空数组 - Kratos v2.6+ 默认使用
grpc-resolver作为客户端解析器，如果服务端没开 gRPC 反射（reflection.Register），客户端 resolve 会超时但不报错
最常被忽略的点：Kratos 的 data 层不是 ORM 封装，而是数据访问抽象层。你写一个 userRepo.FindByID，它不会自动帮你加缓存、熔断或 trace，这些都得靠中间件显式挂载。以为“分层了就万事大吉”，结果线上慢查询全堆在 data 层里。
