beego orm 默认不支持 sqlite 是因为未内置其驱动，必须手动导入 github.com/mattn/go-sqlite3、调用 orm.registerdriver("sqlite3", orm.drsqlite) 注册驱动，并用绝对路径注册数据库；否则会报 driver 未知或表不存在错误。
Beego 能直接用 SQLite，但必须手动注册驱动、显式指定文件路径、禁用连接池——否则 Open 会静默失败或报 no such table，哪怕表明明已建好。
为什么 beego ORM 默认不支持 sqlite3
Beego 的 orm.RegisterDriver 不内置 SQLite 驱动，它只预置了 MySQL 和 PostgreSQL 的注册逻辑。你得自己导入 github.com/mattn/go-sqlite3 并调用 orm.RegisterDriver，否则 orm.RunSyncdb 会找不到驱动而 panic。
- 不 import 驱动包 → 编译通过但运行时报
driver: unknown driver "sqlite3" (forgotten import?) - 没调用
orm.RegisterDriver("sqlite3", ...)→orm.RegisterDataBase直接 panic - 路径写相对路径（如
data/app.db）→ 程序在不同目录启动时数据库文件位置漂移，导致“表不存在”错觉
如何正确注册 sqlite3 驱动并初始化 ORM
必须在 main() 开头、beego.Run() 之前完成三件事：导入驱动、注册驱动、注册数据源。顺序不能错，且路径要用绝对路径。
- 在
main.go顶部加：import _ "github.com/mattn/go-sqlite3"（下划线是关键，触发 init） - 在
main()函数开头加：orm.RegisterDriver("sqlite3", orm.DRSqlite) - 注册 DB 时路径必须绝对化：
orm.RegisterDataBase("default", "sqlite3", filepath.Join(beego.AppConfig.String("apppath"), "data", "app.db")) - SQLite 不支持连接池，务必禁用：
orm.SetMaxIdleConns("default", 0)和orm.SetMaxOpenConns("default", 1)
使用 sqlite3 时 beego migrate 的兼容性陷阱
bee migrate 基于 SQL 脚本执行，但 SQLite 的语法限制多，很多 MySQL/PostgreSQL 习惯写法会直接报错。
-
ADD COLUMN xxx INT DEFAULT 0 NOT NULL→ SQLite 不允许NOT NULL加默认值的组合，得拆成两步或去掉NOT NULL -
COMMENT 'xxx'→ SQLite 忽略注释，但bee migrate会原样执行，导致语法错误 -
ALTER TABLE t RENAME TO t_old→ SQLite 仅支持重命名表，不支持重命名列，RENAME COLUMN是 3.25+ 才有，旧版本会失败 - 迁移文件里别写
ENGINE=InnoDB或CHARSET=utf8mb4—— SQLite 完全不认这些
事务与并发写入的现实约束
SQLite 是文件锁级并发，同一时刻只允许一个写入者。beego ORM 的 orm.Begin() 虽能开启事务，但若多个 goroutine 同时写同一个 DB 文件，后到的会阻塞甚至超时返回 database is locked。
- 别在 HTTP handler 里长期 hold 事务，尤其是涉及外部 API 调用时
- 写密集场景下，
PRAGMA journal_mode = WAL可提升并发读写能力，需在RegisterDataBase后立即执行：orm.Raw("PRAGMA journal_mode = WAL").Exec() - 避免在循环中反复
Insert，改用InsertMulti或事务批量提交
SQLite 在 Beego 里不是“换掉 MySQL 就能跑”的平替，它的单文件本质决定了你得主动管理路径、锁、语法边界和并发模型——漏掉任意一环，问题都藏在运行时才暴露。
