go读写分离必须用两个独立*sql.db实例，主库处理写和强一致性读，从库仅处理最终一致性读；dbresolver不识别写语义sql、不感知复制延迟、无自动故障剔除，需手动管理连接池、健康检查与延迟监控。
Go 里没有“框架自动搞定读写分离”这回事，所有稳定上线的方案都基于两个独立 *sql.DB 实例——一个连主库，一个或多个连从库。试图用单个 *sql.DB 配多个地址、靠正则解析 SQL、或依赖 ORM 自动识别读写语义，都会在生产环境出问题。
为什么 GORM 的 dbresolver 不能直接开箱即用
它只按调用方法硬编码路由：比如 Create/Update 强制走主库，Find/First 默认走从库。但它不看 SQL 内容，所以遇到 SELECT ... FOR UPDATE 或 INSERT SELECT 这类以 SELECT 开头但实际是写操作的语句，仍会发到从库，直接报错：ERROR 1290 (HY000): The MySQL server is running with the --read-only option。
- 强一致性读（如支付前查余额）必须显式标记，例如
db.Clauses(dbresolver.Write).First(&user) -
Raw("UPDATE ...")默认走从库，不加.Clauses(dbresolver.Write)就会失败 - Replicas 列表是静态配置，节点宕机后不会自动剔除，得自己做健康检查 + 调用
Resolver.ReplaceReplicas() - 它不感知复制延迟，从库 lag > 5s 时照样转发请求，导致“刚提交就查不到”
手动管理两个 *sql.DB 实例的关键配置差异
主库和从库不是“换了个地址”，而是负载特征完全不同的服务端点，连接池参数必须分开调优：
- 主库：
masterDB.SetMaxOpenConns(20)、masterDB.SetConnMaxLifetime(5 * time.Minute)、masterDB.SetWriteTimeout(2 * time.Second)，初始化后立刻masterDB.Ping()，失败直接 panic - 从库：
slaveDBs[i].SetMaxOpenConns(100)、slaveDBs[i].SetConnMaxLifetime(10 * time.Minute)、slaveDBs[i].SetReadTimeout(8 * time.Second)，首次读前异步Ping()，超时则标记isHealthy = false - 每个
*sql.DB必须单独defer db.Close()，尤其 CLI 工具或测试中容易漏掉 - 绝不能复用
sql.Open()返回值或浅拷贝指针——*sql.DB是有状态对象，不是配置模板
事务内混用主从库的典型错误现象
最隐蔽的问题不是报错，而是数据不一致：事务里用 slaveDB.QueryRow() 查了旧值，再用 masterDB.Exec() 更新，结果基于过期快照做了错误决策。
- 一旦调用
masterDB.Begin()，后续所有操作必须基于返回的*sql.Tx实例，不能穿插调用slaveDB.QueryRow() - 封装的全局
ReadDB()函数在事务函数里无意识调用，等于开了两个独立会话，刚写的数据在从库根本看不到 - ORM 自动生成的
Find()如果没走事务上下文，可能被路由到从库，破坏 ACID 隔离性 - PostgreSQL 场景下，
pgx.Tx和sqlx.DB不兼容，不能混用——事务对象无法跨 driver 传递
从库健康与延迟感知必须自己补
GORM 和 database/sql 都不提供原生复制延迟检测能力，你得自己查 SHOW SLAVE STATUS 或 pg_replication_slots，并动态调整路由策略。
- 维护一个可变从库列表，每个节点附带
lastReplicationLag（秒级）、isHealthy（心跳结果）、weight（静态权重） - 每次读请求前过滤掉
!isHealthy或lastReplicationLag > 10的节点，再加权随机选，而非纯随机 - 定期异步更新状态（例如每 5 秒轮询一次），避免把流量打到已断连或延迟高的从库上
- 从库连接超时（
dial tcp 10.0.1.2:3306: i/o timeout）只影响读，不应触发主库接管全部流量；但若业务降级到主库又没限流，主库可能被打爆
真正难的不是怎么写两行 sql.Open，而是把连接池调参、健康探测、延迟阈值、降级开关、事务边界这些细节全串起来，且在并发场景下不出错。任何环节松动，都会在高流量时暴露为“查不到刚写的记录”或“主库 CPU 突然拉满”。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
