go语言无原生读写分离，database/sql仅提供接口，路由需上层实现；正则匹配sql易误判（如select for update），导致从库只读报错；gorm dbresolver需手动配置主从连接池、健康检查与超时，事务中混用主从库将引发数据不一致。
Go 语言本身不提供读写分离能力，database/sql 只是标准接口层，所有路由逻辑必须由上层框架或手动控制；依赖正则匹配 SQL 关键字（比如“SELECT”）来分发请求，会在 SELECT ... FOR UPDATE、INSERT ... SELECT 等语句上直接失败——从库报错 ERROR 1290 (HY000): The MySQL server is running with the --read-only option 是最常见且隐蔽的线上事故起点。
为什么不能用正则判断 SQL 类型做读写路由
SQL 解析成本高，database/sql 和主流 ORM（如 GORM、XORM）都把 query 当作纯字节流交给驱动，不做语法分析。所谓“读操作走从库”，本质是开发者自己定义规则，但规则极易失效：
-
SELECT COUNT(*) FROM orders WHERE status = 'pending' FOR UPDATE语义是写，但开头是 SELECT - GORM 的
Preload("Profile")可能触发 N+1 查询，其中某次隐式查询带锁或跨事务，仍需主库 -
WITH RECURSIVE查询可能修改临时状态，MySQL 要求在可写节点执行 - 任何含
LOCK IN SHARE MODE或FOR UPDATE的语句，必须路由到主库，否则直接报错
GORM dbresolver 插件的正确初始化姿势
别信“一行配置自动分流”的宣传话术。GORM 的 dbresolver 不是开箱即用，它只负责按 session 标记做简单转发，底层连接池、健康检查、超时策略全得手动配齐：
- 主库和从库必须分别调用
sql.Open()初始化，不能共用一个*sql.DB实例再浅拷贝——连接池参数（SetMaxOpenConns、SetConnMaxLifetime）完全不同 - 主库 DSN 单独传给
GORM.Open()，从库 DSN 必须用db.AddSlave()显式注册，且每个都要检查返回的error；注册失败不会 panic，但后续读请求会静默 fallback 到主库 - 从库连接池要单独设置：
slaveDB.DB().SetMaxIdleConns(10)、slaveDB.DB().SetMaxOpenConns(50)，否则默认复用主库参数，容易压垮从库 - 启动时必须对每个从库做
slaveDB.Ping()，失败要告警而非忽略——GORM 不自动剔除不可达节点
事务内混用主从库的真实风险
最危险的不是报错，而是数据不一致。典型错误模式：
- 在事务里用
slaveDB.QueryRow()查用户余额，再用masterDB.Exec()扣款，业务逻辑基于从库返回的过期快照做判断 - 用
db.WithContext(ctx).Session(&gorm.Session{ReadOnly: true})强制走从库，但 ctx 已携带事务信息，GORM 仍可能退回到主库，行为不可控 -
db.Unscoped().Where("id = ?", 1).First(&u)这类操作绕过软删除，但若底层加了FOR UPDATE，仍会被路由到主库——你根本没写，ORM 自动生成了
强一致性读（比如创建后立即详情页）唯一可靠方式是显式用主库：直接调 masterDB.First(&u)，别依赖上下文或 session 标记。
从库连接泄漏与延迟抖动的排查线索
现象常表现为：服务运行几小时后，从库连接数暴涨、CPU 飙高，或突然大量 dial tcp: i/o timeout。根源往往在连接生命周期管理：
- 没设
SetConnMaxLifetime，MySQL 侧因wait_timeout=300主动 kill 连接，Go 端仍尝试复用，触发频繁重连 - 从库健康检查缺失，宕机节点持续接收流量，直到连接超时才 fallback，期间请求全部堆积或失败
- HTTP 服务 shutdown 阶段没统一调
masterDB.Close()和slaveDB.Close()，测试或 CLI 场景下连接泄露无法回收 - 日志里看不到明显异常，得靠
db.Debug().Find(&u)观察实际执行 IP，或抓包确认请求是否真发到了从库
真正难的不是配通，而是让每条 SQL 在正确时间、正确节点、以正确参数执行——这需要对 MySQL 复制机制、GORM 内部 session 传播、以及你自己代码里每个 Query 的语义有清晰判断。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
