Golang微服务对接不同数据库集群必须按集群类型逐个选对客户端、隔离连接池、显式路由请求；混用client、共享sql.DB或gorm.DB、依赖中间件智能分库是90%线上故障根源。
直接上结论：Golang 微服务对接不同数据库集群，不是靠“自动适配”或“统一抽象”，而是靠**按集群类型逐个选对客户端、隔离连接池、显式路由请求**。混用 client、共享 sql.DB 或 *gorm.DB、靠中间件“智能分库”，90% 的线上故障都源于这三类操作。
MySQL 主从集群必须用独立 *sql.DB 实例，且 DSN host 不能写 VIP
主从不是靠应用层“判断读写”来路由，而是靠物理连接指向明确节点：
- 写操作只走主库 DSN，host 必须填主库真实 IP（如
"10.0.1.10:3306"），不能填负载均衡 VIP —— VIP 会破坏事务一致性，db.Exec("BEGIN")和后续db.Query可能落在不同物理连接上 - 读操作可走从库 DSN，但必须是独立变量（如
slaveDB），不能和masterDB共享sql.Open返回值 -
SetMaxOpenConns要分开调：主库设高些（如 50），从库设低些（如 20），避免主库突发写流量耗尽连接池，导致从库查询排队 - 别在事务里调
slaveDB.Query：MySQL 不支持跨实例事务，masterDB.Transaction()内任何对slaveDB的操作都游离于事务外
Redis Cluster 必须用 redis.NewClusterClient()，禁用单节点 client
用 redis.NewClient() 连 Redis Cluster 节点，必报 MOVED 或 ASK 错误，不是配置问题，是协议不兼容：
-
Addrs至少填一个在线节点（如[]string{"10.0.1.1:6379"}），client 启动后自动执行CLUSTER SLOTS发现全量拓扑 - 所有集群节点间 TCP 端口必须互通（不只是客户端能连某一个），否则
NewClusterClient()初始化卡住或报 “cluster supports only redis v3.0+” 这类误导性错误 - 多 key 操作（
MGET、DEL）要求 key 带相同 slot 前缀，例如"user:{1001}:profile"和"user:{1001}:settings"才安全；"user:1001:profile"和"order:2002:info"会因 hash 不同被路由到不同节点，触发CROSSSLOT报错
GORM 多集群共存要满足三个硬性前提
GORM 不是“多数据库框架”，它只是把 *sql.DB 封装得更厚一层。多个 *gorm.DB 实例能共存，前提是：
立即学习“go语言免费学习笔记（深入）”；
- 驱动导入必须带下划线：
import _ "gorm.io/driver/mysql"，漏了就静默失败，首次Create()卡死或报"invalid connection" - 每个
*gorm.DB必须绑定独立*sql.DB实例，不能复用底层连接池；gorm.Open(mysql.New(...), &gorm.Config{})的第一个参数必须是全新*sql.DB - 事务绝对不跨实例：哪怕两个 GORM 实例都连同一套 MySQL 主从，
db1.Transaction()内调db2.Create()也完全不在事务范围内，且可能因连接池竞争引发超时
etcd + Raft 集群的 client 初始化必须带独立 grpc.DialOption
微服务若需直连 etcd 集群做服务发现或分布式锁，clientv3.New() 的 Config 不能复用：
-
Endpoints必须是完整列表（如[]string{"10.0.2.1:2379", "10.0.2.2:2379", "10.0.2.3:2379"}），不能只写一个 —— 单 endpoint 故障即整个 client 不可用 -
grpc.WithTransportCredentials和grpc.WithBlock要显式设置；没配WithBlock时，New()可能立即返回但底层连接未就绪，后续Put()直接 timeout - 如果服务同时连多个 etcd 集群（如测试/生产环境隔离），每个 client 必须用独立
clientv3.Client变量，且context.WithTimeout要单独控制，避免一个集群慢拖垮全部
最常被忽略的一点：所有集群客户端的连接池、重试策略、超时设置，都不能依赖“全局默认”。比如 redis.ClusterOptions.PoolSize 默认是 10，但在高并发微服务里往往不够；clientv3.Config.DialTimeout 默认 5s，而跨机房 etcd 建连可能需要 8s —— 这些值必须按实际网络状况逐个调优，而不是写死或沿用示例代码。
