kratos.New() 启动 panic 的根本原因只有三个:没加载配置、没创建 server 实例、没将 server 实例传入 Server 参数列表;conf.Load() 必须在 main() 第一行显式调用并传入 config.Provider,grpc.NewServer() 和 http.NewServer() 必须非 nil 且一并传入。

kratos.New() 启动就 panic,不是代码写错了,是基础初始化漏了三件事:没加载配置、没创建 server 实例、没传进 kratos.New()。
conf.Load() 必须在 main() 第一行调用
kratos.New()内部会主动触发配置加载,但默认没注册任何config.Provider不报“找不到 config.yaml”,而是直接 panic:
no config provider registered必须在
main()函数开头就调用,不能等日志初始化完、flag 解析后再做-
调用示例:
func main() { c := config.New(config.WithProvider( config.NewFile("configs/config.yaml"), )) conf.Load(c) // ← 必须第一行! <p>httpSrv := http.NewServer() grpcSrv := grpc.NewServer()</p><p>app := kratos.New( kratos.Name("helloworld"), kratos.Server(httpSrv, grpcSrv), ) // ... } 如果
configs/config.yaml不存在,c.Load()会返回 error,必须检查,否则后续 panic 更难追别依赖
$CONFIG_PATH自动替换:环境变量要自己拼进config.NewFile(os.Getenv("CONFIG_PATH"))
service.Register() 报 rpc error: code = Unavailable
- 这个错误不是服务没连上注册中心,而是本进程里压根没启动
grpc.Server -
service.Register()是向本进程内已运行的grpc.Server实例注册,不是远程注册 - 常见漏点:
- 没调
grpc.NewServer(),或它返回了nil(比如 consul 初始化失败但只判 error,漏了 nil 检查) - 创建了
grpc.Server,但没传给kratos.New(kratos.Server(httpSrv, grpcSrv)) - 监听地址写成
localhost:9000:某些容器或 CI 环境下解析失败,应改用0.0.0.0:9000
- 没调
- 如果项目只用 HTTP,完全不用
service.Register()—— REST 接口走http.Server独立路由,不依赖 gRPC
protoc-gen-go-grpc 缺失导致生成代码无 RegisterXXXServiceServer
- Kratos 的 gRPC 注册函数(如
RegisterGreeterServiceServer)不是protoc-gen-go生成的 - 必须同时安装并启用两个插件:
go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest go install github.com/go-kratos/kratos/cmd/protoc-gen-go-http/v2@latest
- 生成命令示例:
protoc --proto_path=api --proto_path=third_party \ --go_out=paths=source_relative:./api \ --go-grpc_out=paths=source_relative:./api \ --go-http_out=paths=source_relative:./api \ api/helloworld/v1/greeter.proto
- 单独装
protoc-gen-go只生成*.pb.go,不生成服务注册逻辑和 HTTP 映射
配置加载顺序、server 实例生命周期、proto 插件组合——这三处不是“可选优化”,而是 Kratos 启动的硬性前提。漏掉任一环,panic 都不会告诉你具体缺什么,只会沉默崩溃。


















