Beego 连接 MySQL 必须三步到位:①以下划线导入 mysql 驱动;②DSN 含 tcp() 和 utf8mb4;③RegisterModel 在 RunSyncdb 前。缺一即报 unknown driver 或 no such table。

Beego 连接 MySQL 不是配个字符串就能跑通的事,漏掉驱动注册、DSN 格式错、模型注册顺序乱,都会直接报 driver: unknown driver "mysql" 或 no such table——这两个错误背后,90% 是配置链断在了前三步。
必须用下划线导入 mysql 驱动
Beego 的 ORM 不会自动加载数据库驱动,import 语句里缺了下划线,init() 就不会执行,驱动压根没注册。
- ✅ 正确写法:
_ "github.com/go-sql-driver/mysql" - ❌ 错误写法:
"github.com/go-sql-driver/mysql"(无下划线,编译不报错但运行时报unknown driver) - ⚠️ Beego v2 用户注意:仍要用
github.com/go-sql-driver/mysql,别换v2版本,beego/v2/client/orm不兼容它
DSN 字符串必须带 tcp() 和 charset=utf8mb4
DSN 写错会导致连不上、中文乱码、甚至静默 fallback 到 Unix socket(本地开发常因此失败)。
Drizzle ORM 是一个轻量级的 TypeScript ORM,提供类型安全的 SQL 模式声明、关系型和类 SQL 查询构建器,以及自动生成迁移。其压缩后仅 7.4kb,且无依赖项,支持 PostgreSQL、MySQL 和 SQLite,包括 Neon、Turso 和 Cloudflare D1 等无服务器数据库。
- ✅ 推荐格式:
username:password@tcp(127.0.0.1:3306)/dbname?charset=utf8mb4&parseTime=true&loc=Local - ❌ 常见错:
root:pass@/test(缺tcp(),Go 默认走 socket,Docker 或远程 MySQL 必挂) - ❌
charset=utf8不够:MySQL 的utf8实际只支持 3 字节 UTF-8,emoji 和生僻字会截断或报错,必须用utf8mb4 - ⚠️ 密码含
@、/等字符?得 URL 编码,比如pa@ss/word→pa%40ss%2Fword
RegisterModel 和 RunSyncdb 的顺序不能颠倒
RunSyncdb 是“基于已注册模型”建表的动作,放错位置等于对空气同步。
- ✅ 正确顺序:
orm.RegisterModel(new(User), new(Order))→orm.RunSyncdb("default", false, true) - ❌ 放反了:
RunSyncdb在RegisterModel前 → 无模型可同步,不报错但表根本不会建 - ⚠️ 第二个参数为
false表示不删旧表,安全;设true会清空已有数据,仅限本地快速重置 - ⚠️
RunSyncdb只在首次启动时生效,改字段后不会自动更新表结构——生产环境应禁用,用bee generate appcode -conn="..." -tables=user反向生成模型更可控
调试时开 Debug,但上线前必须关
orm.Debug = true 能打 SQL 和参数,查 ReadOrCreate 失败、QueryTable 返回空特别管用,但代价是性能暴跌和日志爆炸。
- ✅ 开发期加在
init()开头:orm.Debug = true - ❌ 生产代码里留着它 → 每次查询都打印完整 SQL+参数,磁盘撑爆,还可能泄露密码、token 等敏感值
- ⚠️ 它不影响 SQL 执行逻辑,纯属日志开关;批量操作时延迟可能翻倍,别在压测或上线前忘了关
真正卡住人的从来不是语法,而是驱动没注册、DSN 少了 tcp()、模型没注册就急着同步——这三处一旦出错,错误信息往往不指向根源。动手前先盯死这三行:_ "github.com/go-sql-driver/mysql"、@tcp(...)、RegisterModel 在 RunSyncdb 前。

















