Documentation
¶
Overview ¶
Package sqlitedrv 是 gormx 的 **opt-in 纯 Go sqlite 入口**。
## 为什么 sqlite 入口必须是独立子包(oekit/gormx#72)
纯 Go 驱动 `github.com/glebarez/sqlite` 在 `init()` 里向 `database/sql` 注册驱动名 **"sqlite"**——这是**链接级副作用**:只要二进制的 import 图里 有它,启动就注册。本入口此前放在核心包 `gormx` 里,导致**每个消费方** (哪怕只用 MySQL)都被强制带上:
- **驱动名冲突,运行时才炸**:消费方再链接任何注册同名驱动的实现 (如 `modernc.org/sqlite`,经 agent-memory/storage/sqlite 等常见链路引入) ⇒ init 顺序即 `panic: sql: Register called twice for driver sqlite`, **不可 recover**。实际炸点:code-review-service 同时用 gormx(MySQL/GORM) 与 agent-memory 的 sqlite 存储,自第七波依赖对齐后 main 二进制启动即 panic;
- **构建成本摊给所有人**:glebarez 的传递依赖(`modernc.org/sqlite` → `modernc.org/libc`)体量大,实测只用 MySQL 的消费方也付冷构建 +5s。
v0.8.0 起 `OpenPureGoSQLite` 迁入本子包(⚠️ breaking:核心包不再导出该入口;v0.12.0 起该旧名删除,统一 `Open`, 迁移=改 import 为 `github.com/oekit/gormx/sqlitedrv`,调用改为 `sqlitedrv.OpenPureGoSQLite`,签名不变)。此后**核心包(`./`、`crud/`、 `gormrepo/`)零 sqlite 链接**:不 import 本子包的二进制既不注册任何驱动, 也不付 sqlite 驱动的构建成本。
「核心包不得链接任何 sqlite 驱动」由 `deps_sqlite_link_test.go` 以 AST 判 import 强制(不靠文本匹配),退回旧写法(把入口挪回核心包)自测必红。
## 仍须注意:注册者必须唯一
显式选用本子包的消费方,二进制里就有了 glebarez 的 "sqlite" 注册——此时再 直接 import `modernc.org/sqlite` 等同名注册者仍会冲突。gormx 只保证 **不替你做决定**;驱动注册者唯一性由选用 sqlite 的消费方自行保证。 mattn 系(`gorm.io/driver/sqlite`)注册的是 "sqlite3",与 glebarez/modernc 不冲突。
Package sqlitedrv 是 gormx 的 sqlite 入口子包(纯 Go 驱动,免 CGO)。
为什么单独成包(oekit/gormx#72) ¶
底层驱动 github.com/glebarez/sqlite(经 github.com/glebarez/go-sqlite)在 init() 里向 database/sql 注册驱动名 "sqlite",而 modernc.org/sqlite 同样在 init() 注册 "sqlite" ⇒ **同一二进制同时链接两者,init 阶段直接 panic**:
panic: sql: Register called twice for driver "sqlite"
此前入口 OpenPureGoSQLite 住在根包 gormx ⇒ 只要用 gormx(哪怕只用 MySQL/CRUD/事务),glebarez 就进依赖图、init 就注册 ⇒ 与任何直接使用 modernc.org/sqlite 的库(agent-memory 等)组合启动即炸(消费方实证: code-review-service,#72)。
现在 glebarez **只被本子包引用**:根包 gormx、crud、gormrepo 的生产代码 零 sqlite 驱动链接(有门禁测试 deps_sqlite_link_test.go 钉住),只有显式 import 本包的二进制才会带上纯 Go sqlite 驱动。
边界(如实声明) ¶
本包与 modernc.org/sqlite 仍**不可同二进制共存**——两者的 init 都注册 "sqlite",这是驱动上游的行为,本包无法消除。既用本包入口又直接 import modernc.org/sqlite 的组合依旧会 panic;需要共存时二选一: 用本包(glebarez 系)或直接用 modernc(不要再引本包)。 mattn 系(gorm.io/driver/sqlite)注册的是 "sqlite3",与两者不冲突。
Index ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
Types ¶
This section is empty.