go-sqlite3驱动在禁用CGO环境（如Alpine容器、CI）会因缺少C依赖报链接错误，需启用CGO并安装对应开发包，或改用纯Go SQLite方案；DSN须用绝对路径，事务操作必须全程使用tx对象，Scan需严格匹配列数与类型且传指针。
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、甚至静默返回空结果。
立即学习“go语言免费学习笔记（深入）”；
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 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，那这条查询完全独立于事务，既不会回滚，也不受锁保护。
更隐蔽的问题是：事务中混用 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 位系统下容易溢出或截断
