Beego ORM连接字符串必须严格为“用户:密码@tcp(地址:端口)/库名?charset=utf8mb4&parseTime=true&loc=Local”，缺一不可；漏tcp、错用localhost、少参数均导致运行时报错。
beego orm.RegisterDataBase 连接字符串怎么写才不报错
连接失败基本都卡在 DSN（Data Source Name）格式错误。常见错误是漏掉 @tcp(...)、参数拼错、或没加必需的查询参数。
正确写法必须包含四部分：用户名:密码@tcp(地址:端口)/数据库名?参数。例如：
orm.RegisterDataBase("default", "mysql", "root:123456@tcp(127.0.0.1:3306)/myblog?charset=utf8mb4&parseTime=true&loc=Local")
关键点：
-
tcp(127.0.0.1:3306)不能省略为/或localhost（某些 MySQL 配置下localhost会走 socket，导致连接失败） -
charset=utf8mb4推荐替代utf8，避免 emoji 和四字节字符乱码 -
parseTime=true必须加，否则time.Time字段读取会 panic -
loc=Local避免时区转换出错（如数据库用 CST，Go 默认 UTC） - & 符号在 Go 字符串中要写成
&（XML/HTML 转义），不是&
为什么 import _ "github.com/go-sql-driver/mysql" 不能少
Beego ORM 是抽象层，不自带任何数据库驱动。它只认注册过的驱动名（比如 "mysql"），但具体怎么连 MySQL，全靠这个匿名导入的驱动包提供底层实现。
现象：没导入时编译能过，但运行时报 driver: unknown driver "mysql" (forgotten import?)。
注意：
MySQL8 CRM Schema Design Expert
下载
面向 CRM 系统的 MySQL 8 数据库模式设计。当用户需要为客户关系管理（CRM）系统设计、评审、优化或生成数据库模式时，应使用此项技能。
- 必须是
import _ "github.com/go-sql-driver/mysql"，不是import "github.com/go-sql-driver/mysql" - 路径要和你
go get的一致；v2 版 Beego 用github.com/beego/beego/v2/client/orm，对应驱动仍用老路径github.com/go-sql-driver/mysql（目前无 v2 驱动） - 如果用的是 TiDB，驱动一样，无需换包
QueryTable 查询时字段名/表名对不上怎么办
Beego ORM 默认按 struct 名小写 + s 当表名（User → users），字段默认用 Go 字段名（大写首字母）映射列名（小写）。一旦数据库实际命名不匹配，QueryTable 就查不到数据或报 table not exist。
解决方法分两层：
- 指定表名：在 model struct 中加
TableName()方法，返回真实表名，例如return "blog_users" - 指定列名：用
orm:"column(username)"标签，例如Username string `orm:"column(user_name)"` - 查全部数据时别直接传 struct 指针给
All()，先确认 struct 字段是否导出（首字母大写）、是否有对应 tag - 调试技巧：打开
orm.Debug = true，看日志里生成的 SQL 是否符合预期
RunSyncdb 自动建表有哪些坑
orm.RunSyncdb("default", false, true) 是开发期快速建表的捷径，但它不是“安全迁移”，而是“删表重建”。生产环境绝对禁用 true 第三个参数（force）。
典型问题：
-
false, true组合会清空已有表并重建，数据全丢 - 字段类型变更（如
string改time.Time）可能失败，ORM 不会自动 ALTER COLUMN - 外键、索引、注释等高级特性需手动在
TableIndex()/TableEngine()等方法里声明，否则不会生成 - 首次运行前，数据库必须已存在（
myblog库得手动CREATE DATABASE好），ORM 不创建库
建议只在本地开发初期用一次，之后改用 SQL 迁移或工具管理 schema 变更。
