Beego ORM必须先注册驱动和数据库再调用NewOrm,否则panic报“no driver found”或“database not registered”;注册顺序不可颠倒,且模型需提前注册、字段首字母大写、DSN须含parseTime=true等关键参数。

必须先注册驱动和数据库,再调用 orm.NewOrm(),否则会 panic 报 "no driver found" 或 "database not registered"
注册驱动和数据库的顺序不能错
Beego ORM 不是“导入即用”,它依赖显式注册。常见错误是把 orm.NewOrm() 写在 orm.RegisterDataBase() 之前,或漏掉驱动注册。
-
orm.RegisterDriver("mysql", orm.DRMySQL)必须执行(v2 版本中可省略,但显式写上更稳妥) -
orm.RegisterDataBase("default", "mysql", "user:pass@tcp(127.0.0.1:3306)/dbname?charset=utf8&parseTime=true&loc=Local")的 alias(第一个参数)必须是字符串"default"或其他自定义名,后续所有o.Using("default")都要匹配它 - 连接字符串里
?charset=utf8&parseTime=true&loc=Local是 MySQL 常见刚需:不加parseTime=true会导致time.Time字段读取为零值
模型注册必须在 init() 或 main() 早期完成
模型没注册,o.Insert() 或 o.QueryTable("user") 会静默失败或 panic。
- 使用
orm.RegisterModel(new(User), new(Profile)),不是RegisterModel(&User{})—— 参数必须是类型指针(new(T)或reflect.TypeOf(&T{})) - 如果模型分散在多个文件,确保所有
init()函数都执行完毕后再调用 ORM 操作(比如放在main()开头、路由启动前) - 字段名必须首字母大写(Go 可导出规则),否则反射无法读取,
ormtag 完全失效
连接字符串里别漏掉关键参数
看似能连上,但时间字段错乱、中文乱码、空值插入失败,大概率是 DSN 缺参数。
-
charset=utf8mb4比utf8更安全(支持 emoji 和四字节 UTF-8) -
parseTime=true是time.Time字段正常工作的前提 -
loc=Local避免时区转换导致的时间偏移(如服务器 UTC、应用本地 CST) - 密码含特殊字符(如
@、/)必须 URL 编码,否则 DSN 解析失败
多数据库场景下 alias 和 Using() 要严格对应
一个项目连 MySQL + SQLite,容易混淆哪个操作走哪个库。
- 注册两个库:
orm.RegisterDataBase("mysql", "mysql", "...")和orm.RegisterDataBase("sqlite", "sqlite3", "...") - 每次操作前必须显式指定:
o := orm.NewOrm(); o.Using("mysql"),否则默认用"default" -
o.QueryTable("user").Filter(...)不会自动识别模型属于哪个库,必须靠Using()切换上下文
最常被忽略的是 parseTime=true 和模型字段首字母大写 —— 这两个点不出错时一切正常,一出错就很难定位,因为没有明确报错,只是数据读出来是空或零值。


















