beego连接mysql核心三步：注册驱动（下划线导入mysql）、配置dsn（含tcp和utf8mb4）、注册模型；顺序错误或dsn缺失tcp/charset会导致“no such table”或“unknown driver”错误。
Beego 连接 MySQL 的核心就三件事：注册驱动、配置 DSN、注册模型——漏掉任一环都会报 no such table 或 driver: unknown driver "mysql"。
注册 MySQL 驱动必须用下划线导入
Beego 的 orm 不会自动加载数据库驱动，必须显式导入并触发 init()。常见错误是直接 import "github.com/go-sql-driver/mysql" 而没加下划线：
- ✅ 正确写法：
_ "github.com/go-sql-driver/mysql" - ❌ 错误写法：
"github.com/go-sql-driver/mysql"（无下划线，驱动不注册） - ⚠️ Beego v2 用户注意：
github.com/beego/beego/v2/client/orm仍依赖该驱动，不能换成github.com/go-sql-driver/mysql/v2
DSN 字符串必须带 tcp(...) 和 charset=utf8mb4
Beego 的 RegisterDataBase 对 DSN 格式敏感，缺省或错写会导致连接失败或中文乱码：
- ✅ 推荐格式：
username:password@tcp(127.0.0.1:3306)/dbname?charset=utf8mb4&parseTime=true&loc=Local - ❌ 常见坑：
root:pass@/test（缺tcp(...)，Go 会尝试 Unix socket，本地开发常连不上） - ❌
charset=utf8不够：MySQL 的utf8实际只支持 3 字节 UTF-8 字符（不支持 emoji），务必用utf8mb4 - ⚠️ 密码含特殊字符（如
@、/）需 URL 编码，例如密码pa@ss/word→pa%40ss%2Fword
模型注册和自动建表的顺序不能颠倒
RunSyncdb 必须在 RegisterModel 之后调用，且仅应在开发阶段启用；生产环境禁用：
- ✅ 正确顺序：
orm.RegisterModel(new(User), new(Order)) orm.RunSyncdb("default", false, true) // 第二个参数 false 表示不删除旧表 - ❌ 错误用法：
RunSyncdb放在RegisterModel前 → 无模型可同步，静默失败 - ⚠️
RunSyncdb是单次行为，重启服务不会重复执行；若字段变更，需手动改表或设第二个参数为true（慎用，会删数据） - ? 更安全的做法：用
bee generate appcode -conn="..." -tables=user,order从已有表反向生成模型
调试时开启 orm.Debug = true 但别留在生产代码里
这个开关能打印每条 SQL 和参数，对排查 ReadOrCreate 失败、QueryTable 空结果等问题极有用：
- ✅ 开发期加在
init()或main()开头：orm.Debug = true - ❌ 生产环境未关闭 → 日志刷爆磁盘，且暴露 SQL 结构和参数（含可能的敏感值）
- ⚠️ 注意：
Debug = true不影响 SQL 执行逻辑，但会显著拖慢性能，尤其批量操作时
最易被忽略的是 DSN 中的 tcp(...) 包裹和 utf8mb4 字符集——很多“连得上但存不了中文”“查不到刚插的数据”问题，根源都在这里。
