Kratos并非大材小用,因其本质是可裁剪的微服务内核:关注册中心、禁gRPC、仅启HTTP服务后,即退化为结构清晰、分层明确、带依赖注入的Go Web框架,天然支持接口约束、逻辑解耦与未来拆分。

适合,但前提是去掉分布式冗余、用对启动方式、不硬套 proto+gRPC 全链路。
为什么中小项目用 Kratos 不等于“大材小用”
Kratos 本质是个可裁剪的微服务内核,不是必须跑在 etcd + gRPC + 链路追踪的完整拓扑里。它默认模板偏重分布式,但框架本身支持单体直启——只要关掉注册中心、跳过服务发现、只启用 http.Server,它就退化成一个结构清晰、分层明确、带依赖注入的 Go Web 框架。
中小项目真正需要的不是“微服务能力”,而是:
– 接口定义有约束(避免 HTTP 路径/参数/错误码随意写)
– 业务逻辑能和数据访问解耦(别把 SQL 塞进 handler)
– 后期万一要拆服务,不用重写整套通信协议
这些,Kratos 的 proto + Wire + 四层结构(API/Service/Biz/Data)天然支持,且不增加运行时开销。
中小项目落地 Kratos 必须关闭的三项默认配置
原生 kratos new 生成的模板会默认拉起注册中心客户端、gRPC Server、OpenTelemetry 初始化等,对单体项目是纯负担。实际使用需手动干预:
- 删掉
internal/conf/conf.proto中所有registry、trace、metrics相关字段,或注释掉对应conf.Registry字段初始化 - 在
cmd/server/main.go的app.New调用中,移除app.WithServer(grpc.NewServer(...)),只保留http.NewServer(...) - 删掉
internal/server/grpc.go文件,以及所有.proto中option (google.api.http) = { ... };以外的 gRPC 绑定(如rpc Create(...)定义)
做完这三步,启动日志里不会再出现 start grpc server at [::]:9000 或 register service to etcd,进程内存占用下降 30%~50%。
proto 文件怎么写才不拖慢开发节奏
中小项目不需要一上来就定义完整 gRPC 接口。proto 只用来干两件事:
– 描述 HTTP 请求/响应结构(替代 struct tag)
– 约束路径、方法、参数校验(通过 google.api.http 和 validate 扩展)
示例(只用于 HTTP):
syntax = "proto3";
package helloworld.v1;
import "google/api/annotations.proto";
import "google/api/field_behavior.proto";
import "google/protobuf/empty.proto";
service HelloWorld {
rpc SayHello(SayHelloRequest) returns (SayHelloReply) {
option (google.api.http) = {
get: "/helloworld/{name}"
additional_bindings {
post: "/helloworld"
body: "*"
}
};
}
}
message SayHelloRequest {
string name = 1 [(google.api.field_behavior) = REQUIRED];
}
message SayHelloReply {
string message = 1;
}
关键点:
– 不写 rpc 对应的 gRPC 方法实现(不生成 xxx_grpc.pb.go)
– 用 buf generate 时只启用 grpc-gateway 和 validate 插件,禁用 go-grpc
– 请求体直接用 SayHelloRequest,不用再定义一遍 struct
Wire 依赖注入要不要简化
要。中小项目不必追求编译期全链路注入。Wire 的价值在于显式声明依赖,而不是强制你写 20 个 Provider 函数。
建议做法:
– internal/data/ 层只提供 NewData(返回 *EntClient 或 *sql.DB)
– internal/biz/ 层构造函数接收具体依赖(如 func NewUserUsecase(data *data.Data)),不封装成 Provider
– internal/server/http.go 中手动 new 业务 usecase,再传给 handler;仅在 cmd/server/main.go 的 app.New 里用 Wire 注入 http.Server 和 data.Data
这样既保住了依赖可见性,又避免了为每个小 service 写 Wire 文件的仪式感成本。
真正容易被忽略的是:中小项目最容易在 proto 定义和 Wire 初始化上陷入“框架正确性洁癖”,结果两周没写一行业务逻辑。架构选型不是比谁更标准,而是比谁更快交付、更少返工。Kratos 的轻量单体模式,恰恰是给这种务实节奏留的后门。











