必须空白导入 mysql 驱动且连接串含 charset=utf8mb4，否则 Beego ORM 静默失败；驱动须写为 _"github.com/go-sql-driver/mysql"，DSN 必须含 tcp() 和 utf8mb4，RegisterModel 必须在 RegisterDataBase 之后调用。
必须空白导入 mysql 驱动，否则 orm.RegisterDataBase 静默失败
Beego ORM 底层依赖 database/sql，它本身不带任何数据库协议实现。MySQL 支持靠 github.com/go-sql-driver/mysql 提供，但 Go 要求驱动必须被“引用”——哪怕不直接调用其函数。漏掉下划线导入，编译无错，运行时却报 driver: unknown driver "mysql" (forgotten import?)。
- 写法必须是
_"github.com/go-sql-driver/mysql"，不能是"github.com/go-sql-driver/mysql"（没下划线）或"mysql"（路径错误） - Beego v2 仍用原驱动路径，不是
go-sql-driver/mysql/v2 -
go mod tidy后检查go.sum是否含该驱动哈希；若没有，说明导入未生效，需手动补全或清理缓存
连接串必须含 tcp() 和 charset=utf8mb4
Beego ORM 不接受简化格式如 user:pass@/dbname。缺 tcp() 会导致解析失败或默认走 Unix socket（本地调试常误配）；缺 charset=utf8mb4 则中文插入乱码、emoji 报错、甚至建表失败（尤其字段含 TEXT 或长字符串时）。
- 正确格式：
user:password@tcp(127.0.0.1:3306)/dbname?charset=utf8mb4&loc=Asia%2FShanghai -
utf8mb4是 MySQL 5.5.3+ 推荐字符集，utf8实际只支持 3 字节 UTF-8，不兼容 emoji 和部分生僻字 -
loc=Asia%2FShanghai显式指定时区，避免time.Time字段写入时区偏移异常 - 密码含特殊字符（如
@、/）需 URL 编码，否则连接串解析中断
RegisterModel 必须在 RegisterDataBase 之后调用
Beego ORM 初始化顺序敏感：先注册数据库连接，再注册模型结构。顺序颠倒会导致 RunSyncdb 找不到对应 DB 别名，或模型字段映射失效（比如自增主键不生效、索引丢失）。
面向 CRM 系统的 MySQL 8 数据库模式设计。当用户需要为客户关系管理（CRM）系统设计、评审、优化或生成数据库模式时，应使用此项技能。
- 典型错误写法：在
init()中先RegisterModel(new(User))，再RegisterDataBase(...) - 推荐统一收口到一个
RegisterDB()函数里，按「驱动注册 → DB 注册 → 模型注册」三步执行 - 如果用了
RunSyncdb("default", false, true)自动建表，确保此时所有模型已注册完毕，否则新表不会生成
配置项从 app.conf 读取时注意 section::key 语法
Beego 的 AppConfig.String("db::host") 这类写法依赖 INI 文件的 section 嵌套语法。写错层级或拼写，String() 返回空字符串，最终拼出的 DSN 变成 root:@tcp(:)/?charset=utf8mb4 ——端口为空、主机为空，连接必然失败。
立即学习“go语言免费学习笔记（深入）”；
-
app.conf中应写成：[db] host = 127.0.0.1 port = 3306 databaseName = myapp userName = root password = pass123
- 读取时严格匹配 key 名：用
beego.AppConfig.String("db::port")，不是"db.port"或"port" - 建议加空值校验：
if host == "" { panic("db::host is empty") }，早暴露配置缺失问题
最容易被忽略的是 DSN 中的 charset=utf8mb4 和驱动空白导入的下划线——这两处不出错则一切顺利，一出错就是静默失败或运行时报错，且错误信息不指向根源。别跳过 go.sum 检查和 fmt.Print(dbcon) 输出验证。
