Kratos 不内置读写分离,需手动实现数据源路由:定义 masterDB/slaveDB 实例,通过 context 或选项显式指定连接,Repository 方法内收口选择逻辑,事务强制走主库,避免脏读与连接池失衡。

Kratos 本身不内置读写分离支持,得自己搭路由层
Kratos 没有像 Laravel 或 Spring Boot 那样提供 read/write 数据源配置项或自动 SQL 解析路由。它把数据访问层完全交由开发者选型和组装——比如用 database/sql + github.com/go-sql-driver/mysql,或者封装成 data 层的 Repository 接口。这意味着读写分离不是“配个 YAML 就生效”,而是要手动实现数据源选择逻辑。
常见做法是:定义多个 *sql.DB 实例(如 masterDB、slaveDB),再配合 context.Context 或函数参数显式指定使用哪个连接。没有 AOP、没有注解、也没有 ThreadLocal,Go 的惯用法更倾向显式传递和组合。
- 别指望
kratos new生成的模板里自带读写分离代码 - 不要试图在
conf/conf.proto里塞read_urls和write_url字段——proto 是配置契约,但 Kratos 不会自动根据字段名做路由 - 若用第三方 ORM(如 GORM),需确认其是否支持多数据源+读写分离策略;Kratos 对 ORM 完全无感,只管你最终传给 Service 的 Repository 是否可用
怎么在 Kratos 里安全地切换 master/slave 连接
最稳妥的方式是把数据源选择逻辑收口到 Repository 接口方法中,而不是依赖全局状态或中间件。例如:
// UserRepository 接口
type UserRepository interface {
Create(ctx context.Context, u *User) error
GetByID(ctx context.Context, id int64) (*User, error)
List(ctx context.Context, opts ...ListOption) ([]*User, error)
}
// 实现里根据 ctx.Value 或 opts 显式决定用哪个 DB
func (r *userRepository) GetByID(ctx context.Context, id int64) (*User, error) {
db := r.getReadDB(ctx) // 可检查 ctx.Value(keyRole) == "readonly"
var u User
err := db.QueryRowContext(ctx, "SELECT ...", id).Scan(&u.ID, &u.Name)
return &u, err
}
- 避免用
goroutine+context.WithValue跨协程传递数据源偏好——容易因上下文泄漏或取消导致误判 - 事务内所有操作必须强制走
masterDB,且需确保整个 tx 生命周期只用一个连接;slaveDB不能参与事务 - 如果业务需要“刚写即读”(比如注册后立刻查用户信息),应在调用方显式传入
WithMasterRead()选项,而不是靠 SQL 解析——Go 里解析 SQL 成本高、易出错、难维护
多数据源下事务、连接池和监控的坑
多个 *sql.DB 实例意味着多个独立连接池,这既是灵活性来源,也是隐患温床:
- 每个
*sql.DB都有自己的SetMaxOpenConns和SetMaxIdleConns,若不统一调优,可能主库连接打满而从库大量空闲 - 主从延迟导致的脏读不会被框架拦截——
GetByID走了slaveDB,但主库刚提交的更新还没同步过来,结果返回旧值;这种问题只能靠业务层加重试、版本号或降级到主库读 - 没有内置的 DataSource 切换日志,建议在 Repository 方法入口打点:
log.Debugw("db query", "role", "slave", "sql", "SELECT ..."),否则线上排查路由错误时两眼一抹黑 - 健康检查要分别对主库、从库做心跳,不能只 ping 主库就认为“数据库正常”——从库挂了但流量还在打过去,等于直接放大故障面
要不要引入 ProxySQL 或 ShardingSphere-Proxy 做透明路由
如果你的团队没有足够人力维护自定义路由逻辑,又确实需要读写分离,代理层反而是更轻量的选择:
- ProxySQL 只需配置
mysql_replication_hostgroups,应用仍连单个地址,SQL 自动分发,对 Kratos 零侵入 - 注意 ProxySQL 的 prepared statement 支持较弱,若 Kratos 项目用了
db.Prepare,需关闭mysql-have-pstmts=0或改用 text protocol - ShardingSphere-Proxy 更重,适合未来要分库分表的场景;纯读写分离有点杀鸡用牛刀,且增加了运维链路长度
- 代理方案绕过了 Go 层的数据源管理复杂度,但代价是丢失了连接粒度的控制能力(比如无法针对某个查询临时提高超时)
真正容易被忽略的是:无论用哪种方式,主从延迟监控必须落地。光看 MySQL 的 Seconds_Behind_Master 不够,得在应用侧埋点统计从库查询的“逻辑延迟”——比如写完后立刻用当前时间戳作为条件去从库查,看能否命中。这个数字才真正影响业务一致性。


















