必须用mattn/go-sqlite3驱动,需启用CGO并安装C编译器和SQLite开发包;DSN须为正确路径加WAL、外键等PRAGMA参数;GORM初始化后须手动执行PRAGMA开启WAL与外键;SQLite连接池应设MaxOpenConns=1,避免锁冲突。

能连,但别指望 Fiber 帮你连——它压根不碰数据库连接逻辑;真正卡住你的,是驱动选型、CGO 开关、DSN 写法和 WAL 模式初始化这四步,漏一个就 Ping() 失败或运行时 database is locked。
用哪个 SQLite 驱动?别踩 mattn/go-sqlite3 的 CGO 坑
必须用 github.com/mattn/go-sqlite3,没别的靠谱选项。GORM v2 的 gorm.io/driver/sqlite 底层也依赖它。
但它强制依赖 CGO 和系统级 C 编译器:
- Alpine 容器里要先
apk add --no-cache musl-dev sqlite-dev - CI 构建时确保
CGO_ENABLED=1,否则编译报undefined reference to 'sqlite3_open_v2' - Windows 用户得装 MinGW 并把
gcc加进PATH,否则go build直接失败 - 想彻底避开 CGO?目前只有
github.com/ncruces/go-sqlite3可选,但它的 WAL 支持和 PRAGMA 控制不如 mattn 稳定
DSN 怎么写才不静默失败?路径和参数都得对
SQLite 的 DSN 本质就是文件路径,不是 URL,拼错参数或用错分隔符会直接导致 driver: bad connection 或后续操作 panic。
正确写法(带关键参数):
./config.db?_journal_mode=WAL&_busy_timeout=5000&_foreign_keys=1
注意三点:
- 用
&连接参数,不是&字符实体或?重复出现 - 路径推荐绝对路径,如
/var/data/app.db;相对路径在 Docker 或 systemd 下极易因工作目录变化而unable to open database file - 不要加
user=、password=这类字段——SQLite 不支持,写了就解析失败
WAL 模式和外键必须手动开,GORM 不会替你干
GORM 的 gorm.Open(sqlite.Open(...)) 成功了,不代表你能并发读写或外键生效。SQLite 默认关闭这两项,且每个新连接都要重设。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器,提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象,支持命名依赖等
初始化后立刻执行:
db.Exec("PRAGMA journal_mode = WAL")<br>db.Exec("PRAGMA foreign_keys = ON")<br>db.Exec("PRAGMA encoding = 'UTF-8'")
漏掉 journal_mode = WAL,多 goroutine 写入时大概率触发 database is locked;漏掉 foreign_keys = ON,哪怕表定义写了 FOREIGN KEY,约束也完全不生效。
如果用 GORM,这些 PRAGMA 必须在 gorm.Open() 返回 *gorm.DB 后、调 AutoMigrate() 前执行,顺序错了就白做。
连接池怎么设?SQLite 不吃 MaxOpenConns 那套
别照搬 MySQL/PostgreSQL 的连接池配置——SQLite 是文件锁模型,SetMaxOpenConns(10) 不仅没用,反而加剧锁竞争。
正确做法:
- 只读配置场景:
db.SetMaxOpenConns(1)+db.SetMaxIdleConns(1),避免空闲连接长期占着文件句柄 - 有写操作:所有变更必须走异步队列或单 worker goroutine,绝不能在 HTTP handler 里直接
db.Exec;否则一个慢写请求就能拖垮整个服务 - 检查错误类型:
if errors.Is(err, sqlite3.ErrBusy)要重试,sqlite3.ErrLocked则说明 WAL 没启用或文件权限不对
最易被忽略的是:SQLite 的“连接”本质是文件句柄 + 内存页缓存,复用 *sql.DB 实例没问题,但别幻想靠增大连接数提升吞吐——瓶颈永远在磁盘锁和 WAL 日志刷盘速度上。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!










