Fiber 不处理数据库，SQLite 连接与配置由 database/sql 或 GORM 决定；常见 panic 原因为驱动未注册（需 import _ "gorm.io/driver/sqlite"），DSN 必须含 _foreign_keys=1、_journal_mode=WAL、_busy_timeout=5000 等关键参数，否则易触发 database is locked 或驱动不支持错误。
直接说结论：Fiber 本身不碰数据库，SQLite 怎么连、怎么配、怎么防崩，全由 database/sql 或 gorm 决定；硬套 “Fiber 集成 SQLite” 这种说法，十有八九会漏掉 _foreign_keys=1、WAL 模式、CGO 环境或驱动注册这些关键点，上线后不是 database is locked 就是 unsupported driver: sqlite。
为什么 gorm.Open(sqlite.Open("db.db")) 一运行就 panic
最常见原因是驱动没注册——GORM v2 不自动加载 SQLite 驱动，必须显式导入匿名包：
-
import _ "gorm.io/driver/sqlite"（注意开头的下划线） - 只写
"gorm.io/driver/sqlite"不带_，init()不执行，驱动就不会注册 - 别混用旧版：
github.com/jinzhu/gorm/dialects/sqlite或github.com/mattn/go-sqlite3直接导致编译失败或运行时 panic - 检查
go.mod，确保只有gorm.io/driver/sqlite，没有其他 SQLite 相关驱动残留
sql.Open("sqlite3", "app.db") 连上了却读不到数据？路径和参数写错是主因
SQLite 的 DSN 看似简单，但路径写法直接影响行为，尤其在容器或跨平台场景下：
- 相对路径如
"app.db"容易因工作目录变化失效；生产环境务必用绝对路径："file:/var/data/app.db?_foreign_keys=1&_journal_mode=WAL" - 参数分隔符是
&（HTML 实体），不是&；写成?_foreign_keys=1&_journal_mode=WAL会解析失败 - 内存库写法是
":memory:"，不是":memory"或"memory"；每次调用都是新实例，别误用于持久化 - SQLite 不支持用户/密码字段，DSN 中出现
user:pass@会导致driver: bad connection
事务失效、外键不触发、并发写锁爆炸？SQLite 默认配置太保守
SQLite 默认行为和多数开发者直觉相反，不手动调优，高并发或复杂模型下必然出问题：
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
- 外键默认关闭：必须在
gorm.Open()后立刻执行db.Exec("PRAGMA foreign_keys = ON") - 默认 journal 模式是
DELETE，写锁粒度大；加?_journal_mode=WAL才支持多 reader + 单 writer 并发 -
_busy_timeout=5000必加，否则多 goroutine 写入时大概率报database is locked - 事务中所有操作必须走
tx.Query/tx.Exec，用db.Query会绕过事务，且不会回滚
Alpine 容器里编译失败？CGO_ENABLED=1 和系统依赖缺一不可
mattn/go-sqlite3 是 CGO 驱动，禁用 CGO 或缺失 C 库时，构建直接失败，错误类似 undefined reference to 'sqlite3_open_v2'：
- 构建命令必须显式启用 CGO：
CGO_ENABLED=1 go build - Alpine 镜像需安装
musl-dev和sqlite-dev：apk add --no-cache musl-dev sqlite-dev - macOS 若用 Homebrew 安装 SQLite，需确保
PKG_CONFIG_PATH指向/opt/homebrew/lib/pkgconfig（Apple Silicon）或/usr/local/lib/pkgconfig（Intel） - 不想折腾 CGO？换纯 Go 方案如
modernc.org/sqlite，但注意它不兼容全部 SQLite C API，比如部分 pragma 指令可能不支持
SQLite 在 Go 里真正难的从来不是“怎么连上”，而是“连上之后怎么不让它在并发、迁移、外键、容器环境下静默失败”。每一个 ? 后面的参数、每一处 _ 导入、每一次 tx. 调用，都是实际踩坑后才意识到不能省。
