beego orm 连接 sqlite 必须显式注册驱动和名为 default 的数据库别名，否则会 panic；需导入 _ "github.com/mattn/go-sqlite3"、调用 orm.registerdriver("sqlite3", orm.drsqlite)、orm.registerdatabase("default", "sqlite3", "data/app.db")，并确保父目录存在且模型已注册。
beego ORM 连接 SQLite 需要注册驱动和数据库别名
beego 的 ORM 不会自动识别 sqlite3，必须显式注册驱动和数据库连接。漏掉任一环节都会导致 panic: driver not found 或 no such table 类错误。
关键点有三个：
- 导入
_ "github.com/mattn/go-sqlite3"（下划线导入，触发 init 注册） - 调用
orm.RegisterDriver("sqlite3", orm.DRSqlite)（虽然 beego 默认已注册，但显式写更稳妥） - 用
orm.RegisterDataBase("default", "sqlite3", "data/app.db")注册连接，路径必须是可写目录下的文件路径，不能是只读路径或不存在的父目录
示例代码片段（放在 main.go 的 init() 中）：
import (
"github.com/astaxie/beego/orm"
_ "github.com/mattn/go-sqlite3"
)
func init() {
orm.RegisterDriver("sqlite3", orm.DRSqlite)
orm.RegisterDataBase("default", "sqlite3", "data/app.db")
orm.RegisterModel(new(User))
}
SQLite 文件路径写错会导致 db 创建失败但无报错
beego ORM 对 SQLite 路径异常“宽容”：如果 "data/app.db" 的父目录 data/ 不存在，它不会自动创建，也不会 panic，而是静默地在当前工作目录下新建一个名为 data/app.db 的文件（注意：不是相对路径，而是字面拼接）——这极易造成你反复检查 data/ 目录却始终找不到 DB 文件。
正确做法是提前确保目录存在：
- 用
os.MkdirAll("data", 0755)在init()开头创建目录 - 路径建议用绝对路径或基于项目根目录的显式路径，例如
filepath.Join(os.Getenv("PWD"), "data", "app.db") - 启动后手动检查
data/app.db是否真实生成（可用file data/app.db确认是否为 SQLite 数据库）
AutoMigrate 在 SQLite 下不支持字段类型变更
orm.RegisterModel(new(User)) + orm.RunSyncdb("default", false, true) 可以建表，但 SQLite 的 ALTER TABLE 能力极弱：AutoMigrate 无法修改已有字段类型、重命名字段或删除字段。一旦模型结构变更（比如把 Name string 改成 Name *string），直接运行会报 no such column 或静默忽略变更。
安全做法只有两个：
- 开发阶段用
bee migrate管理结构变更（推荐），生成带Up()/Down()的迁移文件，明确控制 SQL 行为 - 或清空
data/app.db文件，让RunSyncdb(..., true, true)重建全量表（仅限本地调试）
别依赖 AutoMigrate 做迭代演进 —— 它在 SQLite 下本质是“建表专用”，不是“结构同步工具”。
查询时要注意 SQLite 的时间字段和 NULL 处理
SQLite 没有原生 datetime 类型，beego ORM 默认将 time.Time 字段存为 TEXT（ISO8601 格式），但如果你手动插入 raw SQL 或用其他工具写入非标准格式（如 Unix timestamp 整数），orm.Read() 会因解析失败而返回零值，且不报错。
常见陷阱：
-
Created time.Time `orm:"auto_now_add;type(datetime)"`在 SQLite 下实际存为字符串，但 ORM 读取时能自动转换；若字段允许 NULL，务必用*time.Time而非time.Time，否则 NULL 会触发 panic - 使用
QueryTable("user").Filter("name__icontains", "adm")时，SQLite 不区分大小写（默认LIKE），但__iexact可能行为不一致，建议测试确认 - 避免在 where 条件中对 SQLite 的 TEXT 时间字段做算术比较（如
created > '2025-01-01'），应统一用time.Time类型字段配合 ORM 构造条件
SQLite 的“宽松性”常掩盖类型问题，上线前务必用真实数据跑一遍完整 CRUD 流程，尤其关注 NULL 和时间字段的读写一致性。
