GORM不支持分库分表,必须由业务层显式控制路由、连接与表名;Model()和TableName()回调无法动态生效,仅Table()可强制指定物理表,分片逻辑需抽成纯函数并为每库预建独立*sql.DB实例。

GORM 本身不支持分库分表,所有路由、连接选择、表名拼接必须由业务层显式控制;试图用 Model() 或钩子自动分片,上线后大概率查错库、写丢数据、事务失效。
为什么不能依赖 GORM 的 Model() 或 TableName() 回调
因为 db.Model(&User{}) 永远绑定 struct 标签里写的 table: "user",不会随分片逻辑变化。哪怕你写了 TableName() string { return "user_" + strconv.Itoa(id%4) },这个函数在 Find() 时根本不会被调用——GORM 只在初始化模型元信息时读一次,后续全走缓存。
-
db.Table("user_2")是唯一能强制指定物理表的 API,每次查询/插入前都得显式调用 -
Session()不继承Table()设置:db.Session(&s).Where(...).Find()会忽略之前设的表名,必须写成db.Session(&s).Table("user_2").Where(...).Find() - 关联查询(
Preload)、事务内嵌套操作、预编译语句(PrepareStmt)都会绕过自定义逻辑,直接打到默认表
怎么安全地选库 + 选表 + 执行 SQL
核心是把分片逻辑抽成纯函数,输入分片键(如 userID),输出 *sql.DB 实例和真实表名。不能复用全局 *gorm.DB,必须为每个物理库预建独立 *sql.DB 实例。
- 分片键必须参与 WHERE 条件,否则无法路由:
WHERE user_id = ?✅,WHERE name = ?❌(会扫全量分片或报错) - 负数 ID 要先取绝对值:
shardID := int64(math.Abs(float64(userID))) % 4,否则-5 % 4 == -1,map 查不到 - 每个
*sql.DB必须单独调SetMaxOpenConns()和SetConnMaxLifetime();别让 4 个分片共用同一套连接池参数,否则热点分片会耗尽连接,报sql.ErrConnDone - 初始化时务必调
db.Ping(),避免首次请求 panic:sql: database is closed
读写分离与分片如何共存
database/sql 不感知主从,GORM 更不会自动识别。你得在 DAO 层封装路由决策:写操作、FOR UPDATE 查询、事务内所有语句,一律走主库实例;普通 SELECT 可按需路由到从库,但要加 context 控制,别靠解析 SQL 字符串判断(不可靠且慢)。
- 用
context.WithValue(ctx, dbRouteKey, "master")显式透传偏好,比正则匹配INSERT|UPDATE更稳定 - 事务内禁止切换实例:
tx := masterDB.Begin()之后所有语句必须用tx,不能中途换从库db - 跨分片 JOIN 无法下推:先查 user 得到一批
user_id,再按user_id % N分组,发多个并发查询到对应分片,最后 Go 层合并
最容易被忽略的三个细节
不是语法问题,而是上线后半夜告警的根源:
- 分片键选错:90% 请求带
tenant_id查数据,却用order_id分片 → 全量扫描,QPS 断崖下跌 - 时间类分片键没配时区:
parseTime=true&loc=UTC漏了,created_at字段入库/查询结果偏移 8 小时,分片映射全乱 - 扩容无兜底:从 4 分片扩到 8,旧数据还在
user_0~3,新路由函数却只算id % 8→ 一半请求查空表,得加一层if id


















