桥接模式解决db操作逻辑与具体驱动实现的解耦问题，核心是隔离sql行为语义与底层驱动细节，如upsert在不同数据库的语法差异，并通过稳定接口+组合方式实现轻量适配。
桥接模式在 Go SQL 驱动层里到底解决什么问题
它不是为了炫技，而是为了解耦 DB 操作逻辑和具体数据库驱动实现。比如你写了一套用户权限校验逻辑，既要跑在 sqlite3（本地开发），又要切到 postgres（生产），但又不想每换一个库就改一堆 Exec、QueryRow 调用——这时候桥接模式才真正有用。
常见错误是把“桥接”当成“抽象工厂”用：一上来就定义一堆 Creator、Product 接口，结果发现 sql.DB 本身已经提供了足够抽象，硬套模式反而让代码更难维护。
- 真正该桥接的是「SQL 行为语义」和「底层驱动细节」，比如
Upsert在sqlite3用INSERT OR REPLACE，在postgres用ON CONFLICT DO UPDATE，这部分逻辑要隔离出来 - 不要桥接
sql.Open的参数拼接逻辑——那是database/sql自己该管的；桥接的是“执行后怎么解释返回值”或“失败时怎么重试” - Go 标准库的
driver.Driver接口已经是桥接雏形，你只需要在它之上再加一层业务语义封装，而不是从零造轮子
怎么用 interface + struct 实现轻量桥接（不依赖第三方框架）
核心是定义一个稳定接口，让不同驱动实现它，而不是让业务代码直接调用 db.Exec。例如：
type UserRepo interface {
CreateUser(name string, email string) error
FindUserByID(id int64) (*User, error)
}
type PGUserRepo struct{ db *sql.DB }
func (r *PGUserRepo) CreateUser(name, email string) error {
_, err := r.db.Exec("INSERT INTO users(name, email) VALUES($1, $2)", name, email)
return err
}
type SQLiteUserRepo struct{ db *sql.DB }
func (r *SQLiteUserRepo) CreateUser(name, email string) error {
_, err := r.db.Exec("INSERT INTO users(name, email) VALUES(?, ?)", name, email)
return err
}
注意：这里不是在模拟 Java 式的抽象类继承，而是利用 Go 的组合与接口隐式实现。关键点在于——
立即学习“go语言免费学习笔记（深入）”；
- 接口方法签名必须稳定，不能因驱动差异加
pgOptions或sqliteFlags这类参数 - 每个实现里对
db的使用要严格限制在该驱动支持的语法范围内，别在SQLiteUserRepo里写RETURNING id - 如果某驱动不支持某个操作（如
sqlite3不支持FOR UPDATE NOWAIT），接口方法应返回明确错误，比如errors.New("not supported on sqlite")，而不是静默降级
为什么不用 sqlmock 做桥接测试会踩坑
很多人想用 sqlmock 模拟不同驱动行为来验证桥接逻辑，结果发现测试通过但线上出错。根本原因是 sqlmock 只 mock sql.DB 的方法调用，并不校验 SQL 语法是否合法、参数绑定是否匹配、事务行为是否一致。
网奇Eshop商城购物系统:集成国内优秀商城系统的成功元素,采用ASP.NET2.0语言设计开发.傻瓜式的管理模式,强大的后台管理,可添加或定制风格精美的模板,网站广告位任意添加,集成在线支付接口,内置简、繁、英三种语言.系统不断升级,力求尽善尽美.网奇商城的目标是:打造国内最到的商城系统！ 升级功能：1.在线备份SQL数据库2.RSS在线订阅器3.整合了支付宝鲜花支付接口。4.整合了网奇E客通在
典型现象：PGUserRepo.CreateUser 在测试里用 sqlmock 返回成功，但实际连 postgres 时因为字段类型不匹配（比如传了 string 给 UUID 字段）直接 panic。
- 桥接层的单元测试必须用真实驱动启动最小实例（如
docker run --rm -p 5432:5432 postgres），哪怕只测一个CreateUser -
sqlmock只适合验证“是否调用了正确语句”，不适合验证“调用后是否按预期工作” - 不同驱动对空值、时间精度、JSON 字段的处理差异极大，这些只能靠集成测试暴露
连接池和上下文传递在桥接层容易被忽略的细节
桥接结构体里存的 *sql.DB 是线程安全的，但很多人忘了它本身不带上下文感知能力。当你在 HTTP handler 里调用 repo.FindUserByID，如果内部直接用 r.db.QueryRow(...)，就丢失了请求超时控制。
正确做法是在桥接接口里显式接收 context.Context：
type UserRepo interface {
CreateUser(ctx context.Context, name, email string) error
FindUserByID(ctx context.Context, id int64) (*User, error)
}
然后每个实现都用 r.db.QueryRowContext 或 r.db.ExecContext。否则你会遇到：
- HTTP 请求已超时，但 goroutine 还卡在
db.QueryRow上，连接池被占满 -
sqlite3驱动对context支持较晚（v1.14+ 才完整），旧版本会忽略ctx直接阻塞 - 某些驱动（如
mysql）在连接断开时不会响应ctx.Done()，需要额外设置readTimeout参数配合
桥接不是写一次就完事的事。驱动升级、SQL 优化、新数据库接入，都会让原本“稳定”的接口边界松动。最常被跳过的一步，是没给每个驱动实现加运行时特征探测——比如启动时检查 db.QueryRow("SELECT version()").Scan(&v)，确认当前连接确实连上了预期的数据库类型。
