gorm 连 sqlite 需显式导入 _ "gorm.io/driver/sqlite"(非普通导入),否则因驱动未注册而报 unsupported driver 错误;sqlite.open 支持磁盘、内存及带参数路径,外键和事务需手动启用。

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免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!











