Kratos 中 HTTP 接口启动只需 proto 正确、server 实例传入、conf.Load() 置于 main() 首行;路由由 (google.api.http) option 定义,需用 protoc-gen-go-http 生成,且 HTTP/gRPC server 需显式创建并传入 kratos.New。

Kratos 里写 HTTP 接口,根本不需要先搞懂微服务、注册中心或 gRPC——只要 proto 定义对、server 实例传进去、conf.Load() 在最前面,/hello 就能跑起来。
proto 文件里怎么写 HTTP 路由映射
关键不是 RPC 名字,而是 option (google.api.http) 这一行。Kratos 不靠代码注释或额外配置文件,全靠这个 protobuf 扩展来绑定 HTTP 方法和路径。
-
get: "/hello"对应 query 参数:请求/hello?name=kratos,HelloRequest.name自动被填充 -
get: "/hi/{name}"对应 path 参数:请求/hi/kratos,name从 URL 路径提取,不走 query - 必须用
protoc-gen-go-http插件生成,只装protoc-gen-go会漏掉 HTTP 路由注册逻辑,greeter_http.pb.go里压根没SayHi的 handler - 如果改了 proto 但接口 404,先检查
make api是否成功执行,再确认生成的*_http.pb.go文件里有没有对应方法的Register调用
kratos.New() panic 的真实原因和修复顺序
错误信息像 panic: no config provider registered 或 rpc error: code = Unavailable,不是代码写错了,是初始化链条断在了前三步。
-
conf.Load()必须是main()函数第一行,不能等日志、flag、wire 初始化完再调;它不读环境变量,config.NewFile("configs/app.yaml")的路径得写死或手动拼 - HTTP server 和 gRPC server 都要显式创建,比如
httpSrv := http.NewServer(...),然后一起传进kratos.New(kratos.Server(httpSrv, grpcSrv));漏掉任意一个,对应协议就起不来 - 如果项目只用 HTTP,就别调
service.Register()——它只向 gRPC server 注册,跟 HTTP 路由完全无关,调了反而因 grpcSrv 为 nil 导致 panic - 监听地址别写
localhost:8000,容器或 CI 环境下可能解析失败,统一用0.0.0.0:8000
业务逻辑写在哪、怎么接入中间件
HTTP 接口的业务处理函数,不在 controller 层,而在 internal/service/xxx.go 里实现 proto 生成的 service 接口方法。
- 比如
rpc SayHello生成了SayHello(ctx context.Context, req *v1.HelloRequest) (*v1.HelloReply, error)方法签名,你就在这文件里写具体逻辑 - 中间件不是挂到路由上,而是通过
http.Middleware(...)传给http.NewServer();常用组合如recovery.Recovery(), logging.Server(logger), validate.Validator() - 自定义中间件要符合 Kratos 的
middleware.Middleware类型:输入http.Handler,返回http.Handler,不能直接套用 net/http 原生中间件写法 - 参数校验靠
validate.Validator()自动触发,前提是HelloRequest字段加了validatetag,例如string name = 1 [(validate.rules).string.min_len = 1];
真正卡住人的从来不是语法,而是 conf.Load() 没放第一行、proto 没用 protoc-gen-go-http 生成、或者把 HTTP 和 gRPC 的启动逻辑混在一起判断。这三处错一个,/hello 就永远 404 或直接 panic。











