Golang怎么连接SQLite数据库_Golang如何用go-sqlite3进行本地嵌入式存储【教程】-Golang-PHP中文网

go-sqlite3驱动在禁用CGO环境（如Alpine容器、CI）会因缺少C依赖报链接错误，需启用CGO并安装对应开发包，或改用纯Go SQLite方案；DSN须用绝对路径，事务操作必须全程使用tx对象，Scan需严格匹配列数与类型且传指针。

golang怎么连接sqlite数据库_golang如何用go-sqlite3进行本地嵌入式存储【教程】

go-sqlite3 驱动不支持 CGO 的环境会直接报错

如果你在 Alpine Linux 容器、某些 CI 环境或禁用了 CGO 的 Go 构建中运行 go-sqlite3，会遇到类似 undefined reference to 'sqlite3_open_v2' 的链接错误。这不是代码写错了，而是驱动依赖 C 编译器和 SQLite C 库。

解决方法只有两个：启用 CGO，或换用纯 Go 实现的替代方案（比如 mattn/go-sqlite3 的 CGO 版本必须开启，而 tinygo/sqlite 或 ziutek/mymysql 类方案不适用 SQLite）。

确认 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 指向正确路径，否则 go build 可能找不到头文件

database/sql.Open 不会立即连接，但 DSN 格式写错会导致后续操作 panic

sql.Open 只是初始化连接池，并不校验数据库是否存在或路径是否可写。真正出问题往往在第一次 db.Ping() 或执行 db.Query 时 —— 尤其是 DSN 中的 _filename 路径拼错、权限不足、或用了非法参数。

常见错误现象包括：no such table（其实是 DB 文件压根没创建成功）、unable to open database file、甚至静默返回空结果。

DSN 必须用完整路径，相对路径容易因工作目录变化失效："file:/tmp/my.db?_foreign_keys=1" 比 "file:my.db" 更可靠
SQLite 不支持用户/密码字段，不要写成 user:pass@/path —— 这会被当成非法 URL 解析，导致 driver: bad connection
追加 ?_busy_timeout=5000 能缓解写锁冲突，尤其在多 goroutine 写入时

事务里用 db.Query 而非 tx.Query 会绕过事务控制

SQLite 支持事务，但 Go 的 database/sql 接口要求显式使用 *sql.Tx 对象执行语句。如果在 tx, _ := db.Begin() 后仍调用 db.Query，那这条查询完全独立于事务，既不会回滚，也不受锁保护。

Golang Uber Dig

使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等

下载

更隐蔽的问题是：事务中混用 db.Exec 和 tx.Query，前者可能触发自动提交（取决于驱动实现），导致部分变更提前落盘。

所有操作都走 tx.Query / tx.Exec / tx.Prepare
别忘了 defer tx.Rollback()，并在成功后显式 tx.Commit()
SQLite 默认是 DEFERRED 事务模式，首次读/写才加锁；如需立即排他，用 tx, _ := db.BeginTx(ctx, &sql.TxOptions{Isolation: sql.LevelExclusive})

QueryRow.Scan 时列数或类型不匹配会 panic，不是返回 error

SQLite 是动态类型，但 Go 的 Scan 方法严格按声明顺序和类型匹配。如果 SQL 返回 3 列，你只传 2 个变量，或把 int64 当 int 传，就会触发 panic: sql: expected 2 destination arguments in Scan, not 1 这类运行时 panic —— 它不会被 if err != nil 捕获。

这个问题在线上环境特别危险，因为开发时数据“刚好对得上”，一换数据就崩。

永远用指针传参：var id int64; err := row.Scan(&id, &name)，而不是 row.Scan(id, name)
不确定列数或类型时，先用 rows.Columns() 拿元信息，再用 rows.Scan 配合 []interface{} 接收
主键自增字段在 SQLite 中通常是 INTEGER PRIMARY KEY，对应 Go 的 int64，不是 int —— 32 位系统下容易溢出或截断