本文详解 go 中使用 database/sql 和 mattn/go-sqlite3 初始化 sqlite 数据库、建表并确保数据持久化的关键要点，包括连接管理、ddl 执行方式及常见陷阱规避。
本文详解 go 中使用 database/sql 和 mattn/go-sqlite3 初始化 sqlite 数据库、建表并确保数据持久化的关键要点，包括连接管理、ddl 执行方式及常见陷阱规避。
在 Go 中操作 SQLite 数据库时，仅调用 sql.Open() 并不真正建立连接或触发写入；它只是初始化一个数据库句柄（lazy connection）。若未显式执行 DDL 语句并正确关闭资源，数据库文件可能保持空或结构未写入磁盘——这正是示例代码中 db.Query() 创建表失败的根本原因。
首先，必须使用 db.Exec() 而非 db.Query() 执行 DDL 操作。Query() 专用于返回结果集的 SELECT 查询，而 CREATE、INSERT、UPDATE 等修改类语句需用 Exec()。否则，SQLite 驱动会静默忽略或报错（如 no such table 后续查询中），但不会提示 DDL 失败。
其次，显式调用 db.Close() 是确保事务提交与缓冲区刷新的关键步骤。虽然 SQLite 默认启用 auto-commit 模式，但 Go 的 sql.DB 连接池机制可能导致底层连接未及时释放，影响元数据写入。尤其在短生命周期程序（如初始化脚本）中，遗漏 Close() 极易导致 .db 文件为空或无表结构。
以下是修正后的完整示例：
package main
import (
"database/sql"
"fmt"
"log"
"os"
_ "github.com/mattn/go-sqlite3"
)
func main() {
// 创建数据目录
if err := os.MkdirAll("./data/1234", 0755); err != nil {
log.Fatal("创建目录失败:", err)
}
// 打开（或创建）SQLite 数据库文件（无需预先 os.Create）
db, err := sql.Open("sqlite3", "./data/1234/data.db")
if err != nil {
log.Fatal("打开数据库失败:", err)
}
defer db.Close() // 推荐使用 defer，确保异常时也关闭
// 使用 Exec 执行建表语句（注意：SQLite 中 AUTOINCREMENT 仅对 INTEGER PRIMARY KEY 有效）
_, err = db.Exec(`
CREATE TABLE customers (
till_id INTEGER PRIMARY KEY AUTOINCREMENT,
client_id VARCHAR(64),
first_name VARCHAR(255) NOT NULL,
last_name VARCHAR(255) NOT NULL,
guid VARCHAR(255),
dob DATETIME,
type VARCHAR(1)
)
`)
if err != nil {
log.Fatal("建表失败:", err)
}
fmt.Println("数据库初始化成功：./data/1234/data.db 已创建并包含 customers 表")
}
⚠️ 注意事项：
- 无需手动调用 os.Create() 创建 .db 文件：sql.Open() + 首次 Exec() 会自动创建并初始化 SQLite 文件；
- 表名和字段名建议避免反引号（`）包裹，SQLite 原生支持无引号标识符，过度转义反而降低可读性；
- 生产环境应添加 ?_busy_timeout=5000 参数（如 "./data/1234/data.db?_busy_timeout=5000"）避免锁等待；
- 若需事务控制（如批量建表），应显式调用 db.Begin()、tx.Commit()/tx.Rollback()；
- 使用 defer db.Close() 替代结尾处直调 db.Close()，提升异常安全性。
通过以上调整，即可确保 SQLite 数据库文件被正确创建、表结构持久化写入，并为后续数据操作奠定可靠基础。
