beego连接mysql需导入mysql驱动并空白导入、连接串必须含tcp()和charset=utf8mb4、init中注册数据库且配置扁平化命名、registermodel须在registerdatabase之后调用。
Beego 连接 MySQL 数据库不是「配个字符串就能用」的事，漏掉驱动注册或连接串格式错误，orm.RegisterDataBase 会静默失败或报 driver: unknown driver "mysql" (forgotten import?) ——这是最常卡住新手的第一步。
必须导入 mysql 驱动且不能省略下划线
Go 的 database/sql 是接口层，具体协议实现靠第三方驱动。Beego ORM 底层用的就是它，所以 github.com/go-sql-driver/mysql 必须以空白导入（underscore import）方式引入，否则运行时找不到驱动：
import (
"github.com/astaxie/beego/orm"
_ "github.com/go-sql-driver/mysql" // ← 这行不能少，也不能写成 "mysql"
)
- 如果用的是
beego/v2，驱动路径仍是github.com/go-sql-driver/mysql，不是go-sql-driver/mysql/v2 - Go Modules 下执行
go mod tidy后检查go.sum是否包含该驱动哈希；若没出现，说明导入未生效 - 常见错误：写成
import "github.com/go-sql-driver/mysql"（没加下划线），编译不报错但运行时报 driver not found
连接串格式必须带 tcp() 和 charset 参数
Beego ORM 不接受简化的连接格式（如 user:pass@/dbname），必须显式指定网络类型和字符集，否则可能因默认编码不匹配导致中文乱码或插入失败：
root:123456@tcp(127.0.0.1:3306)/mydb?charset=utf8mb4
-
tcp(...)不能省略，unix(/var/run/mysqld.sock)是另一套路径写法，别混用 -
charset=utf8mb4推荐，兼容 emoji 和四字节 UTF-8；charset=utf8在 MySQL 8.0+ 中实际映射为utf8mb3，有兼容风险 - 端口必须是字符串（
"3306"），拼接时别漏引号；配置文件读取的值默认是 string，但手动写死时要注意类型
init 函数里注册前要确保配置已加载
Beego 的 beego.AppConfig 在 beego.Run() 之前才完成初始化。如果你把数据库注册逻辑放在 main() 函数里，而不是 init() 或 main() 开头调用的函数中，AppConfig.String() 会返回空字符串：
func init() {
// ✅ 正确：init 阶段可安全读取 app.conf
user := beego.AppConfig.String("db_user")
pwd := beego.AppConfig.String("db_pass")
host := beego.AppConfig.String("db_host")
port := beego.AppConfig.String("db_port")
name := beego.AppConfig.String("db_name")
dsn := fmt.Sprintf("%s:%s@tcp(%s:%s)/%s?charset=utf8mb4", user, pwd, host, port, name)
orm.RegisterDataBase("default", "mysql", dsn)
}
- 别在
main()函数体第一行就调orm.RegisterDataBase，此时配置还没加载 - 多个库注册时，每个
RegisterDataBase的第一个参数（alias）必须唯一，比如"default"、"slave"，后续orm.NewOrm().Using("slave")才能路由过去 - 开发环境建议加
orm.Debug = true，能看到每条 SQL 和执行耗时
conf/app.conf 里的键名不能含点或特殊字符
Beego 的配置解析器对 key 名敏感：dev.db.user 这种嵌套写法会被截断为 dev，导致 AppConfig.String("dev.db.user") 返回空。必须扁平化命名：
db_user = root db_pass = 123456 db_host = 127.0.0.1 db_port = 3306 db_name = beego_demo
- 不要用
DB_USER或db-user，Beego 默认只认小写字母 + 下划线组合 - 密码含特殊字符（如
@、/）时，连接串需 URL 编码，但更稳妥的做法是改用环境变量或单独配置文件，避免硬编码泄露 - 配置项缺失时，
AppConfig.String()返回空字符串而非 panic，容易被忽略——建议加非空校验并 panic 提示
RegisterModel 必须在 RegisterDataBase 之后调用，否则模型注册无效；而很多教程把这两者顺序写反了，导致后续 Insert 报 table not registered 却查不出原因。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
