Kratos中限界上下文应映射为独立根目录(如userctx),每上下文内按api/service/biz/data四层组织;proto需按上下文隔离、数据库与repo严格隔离、跨上下文通信优先事件驱动而非直连repo或同步RPC。

Kratos 是一个面向云原生的 Go 微服务框架,它本身不强制 DDD 结构,但提供了足够灵活的分层(如 api、service、biz、data)来支撑限界上下文的物理落地。划分是否合理,关键不在框架能力,而在你如何组织目录、模型和通信边界。
限界上下文在 Kratos 里怎么映射成目录结构
Kratos 默认按“技术分层”组织代码,但限界上下文是业务概念——不能直接套用 internal/service 或 internal/biz 这类通用目录名来代表一个上下文。
- 每个限界上下文应有独立的根目录,比如
userctx、orderctx、paymentctx,而不是把所有业务塞进internal/biz - 上下文内部才使用 Kratos 推荐的四层:
api/(gRPC/HTTP 接口定义,含 proto 文件)service/(接口实现,调用 biz 层)biz/(领域逻辑,含实体、聚合、领域服务)data/(数据访问,含 repo 接口与具体实现) -
pkg/下可放跨上下文的通用能力(如pkg/idgen),但禁止放业务模型或术语——那是每个上下文自己的事
常见错误:把 user 和 profile 放进同一个 user 目录,结果 profile 的状态变更触发了 user 的事件监听,却没意识到它们本该属于不同上下文(例如 identityctx vs profilectx)。
proto 文件必须按限界上下文隔离,不能全局共享
Kratos 强依赖 protobuf 定义 API 和数据契约,而 proto 的 package 名和路径就是上下文边界的显式声明。
- 每个上下文的 proto 必须用唯一 package,例如:
package userctx.v1;(不是package api;)package orderctx.v1; - 所有 message 名、service 名需带上下文前缀或后缀,避免歧义:
UserProfile在userctx中合法,在profilectx中就该叫Profile或ProfileData - 禁止跨上下文 import proto —— 如果
orderctx需要用户 ID,只 importuserctx.v1.UserID(值对象),不 importuserctx.v1.User(实体)
否则你会在生成代码时发现字段冲突、循环依赖,或者上线后因某个上下文改了 User 字段导致另一上下文 panic。
数据库和仓储(repo)必须严格隔离
Kratos 的 data 层支持多种驱动,但限界上下文要求“每个上下文拥有专属数据库或 schema”,不是“专属 repo 接口”。
-
userctx/data/user_repo.go只能操作users表(或userctx.usersschema),不能读写orders - 如果多个上下文共用一个物理数据库,必须通过 schema 隔离(如 PostgreSQL 的
userctx、orderctxschema),而非靠表名前缀糊弄 - 跨上下文数据获取必须走 API 或事件,不能直连对方的 repo —— 即使都在同一进程内,也要用
userctx.Client调用,而不是userRepo.GetByID
容易踩的坑:为图省事在 orderctx/biz/order.go 里 new 一个 userctx/data.UserRepo 实例去查用户信息。这破坏了上下文边界,也绕过了 auth、rate limit、trace 等网关层能力。
上下文间集成优先用事件,慎用同步 RPC
Kratos 提供 kratos/pkg/conf/paladin 和 kratos/pkg/log,但没内置消息中间件。你需要自己选型(如 Kafka、NATS)并封装到上下文的 data/eventbus 层。
- 同步调用(gRPC)适合强一致性场景,但会带来耦合和级联失败风险;
例如orderctx创建订单时同步调用paymentctx预占额度,一旦支付服务不可用,订单就卡住 - 事件驱动适合最终一致性:
orderctx发出OrderCreatedEvent→paymentctx订阅并异步处理 → 失败时重试或告警
这种方式让上下文真正“解耦”,也符合 DDD 中“上游不关心下游如何响应”的原则
注意:不要在 service 层直接发事件,应在 biz 层的领域服务或聚合根方法中 emit,再由 service 层统一 dispatch——这样才能保证事务边界(例如 DB commit 成功后再发事件)。
真正的难点从来不是 Kratos 怎么写,而是你能否在第一次建 userctx 目录时,就拒绝把“用户收货地址”放进 userctx,而是划给 addressctx——因为地址变更不只影响用户,还影响订单履约、物流调度等多个上下文。这个判断,框架帮不了你。


















