Kratos 不支持开箱即用的多数据源动态切换,其 internal/data 层默认仅封装单数据源;多数据源需开发者手动初始化多个 *sql.DB 实例,通过 Wire 注册、结构体聚合或上下文动态构造 DSN 实现,常见于读写分离、业务分库、租户隔离等场景。

多数据源在 Kratos 中不是开箱即用的功能
Kratos 的 internal/data 层默认只封装单数据源(比如一个 MySQL 实例或一个 Redis 实例),框架本身不提供原生的「动态切换主从」「按业务分库」「读写分离路由」等能力。如果你看到项目里有多个数据库连接,那一定是开发者自己在 data 层手动初始化了多个 *sql.DB 或 *redis.Client,再通过参数、上下文或中间件显式选择使用哪一个。
常见多数据源场景及实现方式
真实项目中,多数据源通常对应这几类需求:
- 读写分离:一个写库 + 多个只读从库,按请求类型(
SELECT/INSERT)自动路由 - 业务分库:用户库、订单库、日志库物理隔离,按业务模块硬编码调用
- 租户隔离:不同租户走不同数据库实例,由请求头或 token 中的 tenant_id 决定
- 灰度/AB 测试:部分流量打到新库,需配合配置中心热更新数据源连接
这些都不是 Kratos 自动做的,而是靠你在 internal/data 里自己组织:
- 把多个
*sql.DB实例注册进 Wire 容器,命名区分(如userDB、orderDB) - 定义一个
DataSources结构体,聚合所有连接,暴露GetUserDB()、GetOrderDB()等方法 - 若需运行时切换(如租户场景),不要在初始化时就
sql.Open死,而是在每次获取连接时根据上下文动态构造 DSN 并缓存*sql.DB
容易踩的坑:连接泄漏、事务跨库、热更新失效
多数据源最常出问题的三个点:
-
*sql.DB是长连接池,不能频繁sql.Open+Close;动态租户场景建议用连接池复用策略,比如按 DSN 哈希做池子 key,避免无限新建 - 事务(
tx, _ := db.Begin())只能绑定单个*sql.DB,跨库事务需用 Saga 或 TCC,Kratos 不介入也不封装 - 如果用 Polaris/etcd 做数据源配置热更新,别直接替换
*sql.DB实例——要先db.Close()再重建,且确保旧连接池上正在执行的查询已结束,否则会 panic
要不要引入 Sharding 中间件?
注意区分:你查到的「Kratos1.x 分库分表中间件」和 go-kratos/v2 是两个完全无关的项目。前者是 2015 年个人写的 JDBC 层路由工具,后者是云原生微服务框架。前者支持库内分片、自动生成 sequenceId,但和 Kratos v2 没任何集成关系。如果你真需要透明分库分表,应评估 ShardingSphere-Proxy 或 Vitess 这类独立代理层,而不是往 Kratos 里硬塞数据路由逻辑。


















