Golang用GORM操作SQLite数据库教程

本文详细讲解了使用 GORM 在 Go 中连接和操作 SQLite 数据库的关键要点与常见陷阱：必须通过下划线导入 `_ "gorm.io/driver/sqlite"` 显式注册驱动，否则会因驱动未注册而报错；sqlite.Open 支持磁盘、内存及带参数的路径（如 WAL 模式），但需注意行为差异；AutoMigrate 在 SQLite 上存在局限，尤其对已有表结构变更易静默失败，推荐配合 SetupJoinTable 或手动迁移；此外，SQLite 默认禁用外键和 WAL 日志模式，需在初始化后主动执行 PRAGMA 启用，才能真正生效——这些细节看似微小，却往往是调试失败的根源，掌握它们能让你的 Go SQLite 开发更稳健高效。

GORM 连 SQLite 不需要额外驱动包（v1.23+ 内置），但默认不启用，必须显式导入 _ "gorm.io/driver/sqlite"，否则会报 unsupported driver: sqlite 错误。

为什么 gorm.Open(sqlite.Open(...)) 会 panic？

常见错误是只写了 import "gorm.io/gorm" 和 "gorm.io/driver/sqlite"，却漏了下划线导入。GORM 的驱动注册机制依赖 init() 函数，没触发就不会注册驱动。

• 必须写成：import _ "gorm.io/driver/sqlite"（注意前面的 _）
• 路径不能错：v2 是 gorm.io/driver/sqlite，不是旧版的 github.com/mattn/go-sqlite3
• 如果用的是 Go Modules，确保 go.mod 中有 gorm.io/driver/sqlite v1.5.0 或更高版本

gorm.Open(sqlite.Open("test.db")) 的参数细节

sqlite.Open 接收一个文件路径字符串，支持内存模式和磁盘模式，但行为差异大：

• 磁盘数据库：sqlite.Open("app.db") —— 文件不存在时自动创建，路径需有写权限
• 内存数据库：sqlite.Open(":memory:") —— 每次 Open 都是全新实例，进程退出即丢数据
• 带参数的路径：sqlite.Open("app.db?_busy_timeout=5000&_journal_mode=WAL") —— 参数用 & 连接，_journal_mode 影响并发写入表现

注意：URL 中的 & 是 HTML 实体，在 Go 字符串里直接写 & 即可，不用转义。

第一次迁移表就失败？检查 AutoMigrate 前是否调用了 SetupJoinTable

SQLite 对 ALTER TABLE 支持有限，AutoMigrate 在已有表上加字段或改类型时容易静默失败（尤其涉及外键、唯一约束）。更稳妥的做法是：

• 开发阶段用全新 DB 文件，避免反复迁移
• 模型含多对多关系时，先手动调用 db.SetupJoinTable(&User{}, "Roles", &UserRole{})，否则 AutoMigrate 可能漏建关联表
• 若需修改已存在字段，别依赖 AutoMigrate，改用 db.Migrator().AddColumn 或原生 SQL

SQLite 的事务隔离和外键默认关闭，GORM 不会帮你开；如果模型定义了 foreignKey 但没在打开 DB 后执行 db.Exec("PRAGMA foreign_keys = ON")，外键约束实际不生效。

终于介绍完啦！小伙伴们，这篇关于《Golang用GORM操作SQLite数据库教程》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布Golang相关知识，快来关注吧！