租户标识必须在Kratos网关层注入并透传,通过X-Tenant-ID等显式方式写入context;GRPC需手动透传metadata;缓存key须含tenant_id前缀;Ent连接池与缓存需租户隔离,确保全程不丢失、不误传。

租户标识必须在 Kratos 网关层就注入并透传
Kratos 本身不内置租户上下文管理,但它的 Transport 层(HTTP/GRPC)和 Middleware 机制足够灵活。你不能等请求进到业务 Service 层才解析租户 ID——那已经晚了,DAO、缓存、日志、限流都可能出错。
正确做法是在网关或最外层 HTTP Server 的中间件里完成租户识别,并写入 context.Context。常见来源包括:
-
X-Tenant-ID请求头(推荐,显式可控) - JWT payload 中的
tenant_id字段(需校验签名且信任 issuer) - Host 域名映射(如
tenant-a.example.com→tenant_a,适合早期 SaaS)
注意:不要用 query 参数或 cookie 传租户 ID,前者易被日志泄露,后者无法用于 GRPC 场景;也不要依赖 session,Kratos 默认无状态。
动态数据源路由得绕过 Ent ORM 的默认连接池
Ent 是 Kratos 推荐的 ORM,但它不原生支持运行时切换数据库连接。如果你选的是「独立数据库」或「共享库独立 Schema」模式,必须自己接管连接获取逻辑。
典型错误是直接在 Repository 层做 if tenant == "a" { useDBA() } ——这会导致连接泄漏、事务失效、连接池污染。
可行方案是:
- 用
ent.Driver封装一个租户感知的连接工厂,每次调用ent.NewClient()时传入对应租户的sql.DB - 把
*ent.Client存在context.Context里,由 middleware 初始化并注入 - 避免在 handler 中 new client,全部通过
service.NewXXXService(ctx)获取已绑定租户的 client
如果用 MySQL,Schema 切换可走 USE tenant_a,但要注意连接池复用时 schema 不会自动重置,必须显式执行或使用带租户前缀的连接池。
GRPC 调用链中租户上下文必须手动透传
Kratos 的 client.Interceptor 不会自动转发 context 中的租户信息。当你从 HTTP 服务调用下游 GRPC 服务时,ctx.Value("tenant_id") 在对方收不到。
必须显式将租户 ID 注入 GRPC metadata:
md := metadata.Pairs("tenant-id", tenantID)
ctx = metadata.NewOutgoingContext(ctx, md)
resp, err := client.DoSomething(ctx, req)
下游服务则需注册 server interceptor 提取并写回 context:
func TenantServerInterceptor() grpc.UnaryServerInterceptor {
return func(ctx context.Context, req interface{}, info *grpc.UnaryServerInfo, handler grpc.UnaryHandler) (interface{}, error) {
md, ok := metadata.FromIncomingContext(ctx)
if !ok {
return nil, errors.BadRequest("tenant", "missing tenant-id header")
}
tenantID := md.Get("tenant-id")
if len(tenantID) == 0 {
return nil, errors.BadRequest("tenant", "empty tenant-id")
}
ctx = context.WithValue(ctx, "tenant_id", tenantID[0])
return handler(ctx, req)
}
}
漏掉这个环节,跨服务的数据查询、缓存 key、审计日志都会错乱。
缓存 key 必须强制包含 tenant_id 前缀
Redis 缓存最容易忽略租户隔离。比如用 user:123 当 key,租户 A 和租户 B 的用户 ID 123 就会互相覆盖。
所有缓存操作必须做两件事:
- key 拼接统一加前缀:
fmt.Sprintf("t:%s:user:%d", tenantID, userID) - 避免用全局 cache client,每个租户应有独立的
*redis.Client实例(或至少独立的redis.Pool),防止连接复用导致命令干扰
特别注意 Ent 的 entcache 插件——它默认不支持租户维度隔离,必须关闭或重写 CacheKey 方法。否则二级缓存会跨租户污染。
真正难的不是写几行租户过滤代码,而是确保 tenant_id 这个字符串从第一个字节进入系统开始,就在每一层中间件、每一次 DB 查询、每一个缓存读写、每一条 Kafka 消息头、每一个定时任务的 cron 表达式里,都不曾丢失、不曾误传、不曾被默认值覆盖。











