fiber是go框架，无法直接使用python的sqlite3模块，因二者语言生态不兼容；go中需用mattn/go-sqlite3等cgo绑定库，并正确配置编译环境与连接参数。
为什么Fiber里不能直接用sqlite3包原生连接
Fiber是Go语言的Web框架，而Python的sqlite3模块是CPython标准库的一部分，只在Python解释器中可用。你在Fiber项目里写import sqlite3会直接报undefined: sqlite3——这不是配置问题，是语言层面不兼容。Go生态里操作SQLite必须用mattn/go-sqlite3这类CGO绑定库，它底层调用的是C实现的SQLite3引擎。
mattn/go-sqlite3安装时常见的CGO错误
运行go get -u github.com/mattn/go-sqlite3失败，十有八九是因为没装CGO依赖或环境变量没设对。常见现象包括：gcc: command not found、undefined reference to sqlite3_*、cgo: C compiler "gcc" not found。
- Linux/macOS：确保已安装
build-essential（Ubuntu）或command line tools（macOS），再执行xcode-select --install - Windows：安装TDM-GCC或MinGW-w64，并把
gcc路径加进PATH - 强制启用CGO：
CGO_ENABLED=1 go build，别用CGO_ENABLED=0——那会导致mattn/go-sqlite3彻底不可用
在Fiber应用中初始化SQLite连接池
Fiber本身不管理数据库生命周期，得你自己封装*sql.DB并注入到fiber.App上下文或全局变量里。别在每个handler里反复sql.Open，否则会快速耗尽文件描述符。
- 用
sql.Open("sqlite3", "test.db?_busy_timeout=5000")，_busy_timeout参数必须加，否则并发写入容易触发database is locked - 调用
db.SetMaxOpenConns(1)——SQLite是文件锁模型，设太高反而降低吞吐，1~5足够 - 在
app.Use(func(c *fiber.Ctx) error { ... })中间件里把db挂到c.Locals，比全局变量更安全
示例关键行：
db, _ := sql.Open("sqlite3", "data.db?_busy_timeout=5000")
db.SetMaxOpenConns(1)
app.Use(func(c *fiber.Ctx) error {
c.Locals("db", db)
return c.Next()
})
执行查询时要注意的SQL语法差异
SQLite的SQL方言和MySQL/PostgreSQL有细微差别，Fiber后端如果照搬其他数据库的写法，会在db.Query阶段静默失败或返回空结果。
- 自增主键必须声明为
INTEGER PRIMARY KEY，写成INT PRIMARY KEY AUTO_INCREMENT会报错 - 没有
NOW()函数，用datetime('now')代替；时间字段建议存TEXT类型（ISO8601格式），避免用DATE或DATETIME类型 - 批量插入用
INSERT INTO t VALUES (?, ?), (?, ?)语法，SQLite 3.7.11+才支持，旧版本只能单条提交 - 事务里别混用
db.Query和db.Exec——前者可能隐式开启新连接，破坏事务边界
SQLite在Fiber里跑得稳不稳，关键不在框架适配，而在你有没有尊重它的文件锁本质和SQL方言限制。一旦开了CGO、设对连接数、避开语法坑，它比任何网络数据库都轻快——毕竟所有IO都在本地磁盘上完成，连TCP握手都省了。
