sqlitedrv

package
v0.12.2 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Nov 16, 2026 License: MIT Imports: 4 Imported by: 0

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)都被强制带上:

  1. **驱动名冲突,运行时才炸**:消费方再链接任何注册同名驱动的实现 (如 `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;
  2. **构建成本摊给所有人**: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

func Open

func Open(dsn string, opts ...gormx.OpenOption) (*gorm.DB, error)

Open 用纯 Go 驱动(github.com/glebarez/sqlite,免 CGO)打开 sqlite 数据库。

与 gormx.OpenMySQL 对称:同样接受连接池与 gorm 选项(gormx.OpenOption)。 选它而不是 gorm.io/driver/sqlite 的原因:该驱动需要 CGO,而 NAS 套件 / 容器镜像通常要求 CGO_ENABLED=0 的静态二进制;且 gormx.IsUniqueViolation 判据本就按纯 Go 驱动的错误文案匹配 ⇒ 入口与判据同源。

Types

This section is empty.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL