Kratos 不提供自动微服务拆分,拆分是架构决策:需先明确领域边界、流量生命周期错峰、团队归属三要素;再通过新建仓库、迁移模块、调整传输与依赖、远程调用改造、隔离配置等步骤落地,框架仅支撑边界实现。

Kratos 本身不提供“自动微服务拆分”能力,拆分是架构决策过程,框架只负责支撑——你得先想清楚边界在哪,Kratos 才能帮你把边界落地为独立可部署的服务。
拆分前必须回答的三个问题
没想清这三点就动代码,90%会返工:
-
领域边界是否稳定:比如「用户」和「订单」在当前业务中是否长期解耦?还是经常要跨库 join、强事务一致?若后者,硬拆会导致大量分布式事务或最终一致性妥协 -
流量与生命周期是否错峰:「商品浏览」QPS 高但逻辑简单,「库存扣减」QPS 低但强一致性要求高——这种天然差异才值得拆;若两个模块永远同起同停、同扩同缩,拆了只是徒增运维负担 -
团队归属是否清晰:一个服务由谁 owner?上线节奏、SLA、监控告警能否独立负责?Kratos 的kratos new生成的是单体结构,拆服务本质是把internal下的 biz/service 模块拎出来,变成新仓库 + 新main.go,没人负责就等于没拆
从单体 Kratos 项目中抽出一个服务的实际步骤
以把「用户中心」从原 helloworld 项目中独立为 user-service 为例:
- 新建仓库,用
kratos new user-service初始化骨架,删掉无关的api/helloworld和internal/helloworld - 把原项目中
internal/user/(含biz、data、service)整个拷进新项目的internal/,注意调整go_package路径和 import 引用 - 修改新项目的
cmd/user-service/main.go,只保留该服务需要的 transport(比如只留 HTTP,删掉 gRPC server)和依赖(比如只注入UserRepo,不引入订单相关 repo) - 在原项目中,把所有调用
user的地方,改为通过 Kratos 的http.Client或grpc.Client远程调用新服务的 endpoint,例如:client := http.NewClient(http.WithEndpoint("http://user-service:8000")) - 配置独立的
configs/config.yaml,尤其注意registry地址(如 etcd)和data数据源(如 MySQL 连接串),确保与原项目隔离
拆分后最常踩的坑
这些不是 Kratos 的 bug,而是拆分动作本身暴露的架构脆弱点:
-
proto 文件分散导致编译失败:原项目共用api/下的 proto,拆开后若未统一管理(比如用 buf.work 或 submodule),protoc会找不到google/api/annotations.proto等依赖——必须把公共 proto 提到独立仓库或third_party/目录,并在所有服务的Makefile中补全--proto_path -
错误码定义冲突:原项目用errors.proto定义了USER_NOT_FOUND = 404,新服务也定义同名枚举但值为400,HTTP 层返回时会被 Kratos 的error handler误转——所有服务的错误码必须全局唯一,建议按服务前缀划分,如USER_NOT_FOUND = 10404 -
配置热更新失效:Kratos 默认用config center(如 Nacos)支持动态配置,但拆分后若每个服务都用自己的 config client 实例,又没配好 namespace 或 group,会导致 A 服务改了 DB 连接串,B 服务也跟着 reload——务必检查config.WithSource的 scope 参数
真正的难点从来不在代码怎么写,而在于「哪个函数该留在本地,哪个该变成远程调用」——Kratos 把 transport 层封装得很薄,正因为它不替你做这个判断。











