不能在每个 controller 中调用 gorm.Open()，因为会创建多个独立连接池导致连接泄漏、并发卡死或“Too many connections”错误；正确做法是在应用启动时全局单例初始化 *gorm.DB 并复用。
Beego 项目里直接用 gorm.Open() 初始化数据库，十有八九会出连接泄漏、并发卡死或 MySQL 报 Too many connections 错误——这不是配置问题，是架构误用。
为什么不能在每个 controller 里调用 gorm.Open()
GORM 的 *gorm.DB 实例本身是并发安全的，底层封装了 *sql.DB，而后者就是 Go 标准库的连接池句柄。反复调用 gorm.Open() 会创建多个独立连接池，每个都占用数据库连接数，且不会自动释放旧池。
- 每次
gorm.Open()都新建一个*sql.DB，连接池不共享 - Beego 的 controller 是多 goroutine 并发调用的，高频建连直接打爆数据库最大连接限制
- 事务无法跨 handler 传递，
db.Begin()和tx.Commit()容易错配或 panic - 预加载（
Preload）、钩子（BeforeCreate）等特性依赖单实例生命周期管理，分散初始化会导致行为不一致
如何正确初始化全局 GORM 实例
必须在应用启动阶段一次性完成初始化，并导出为包级变量或注入到依赖容器中。推荐放在 utils/db.go 或 models/init.go 中：
package models <p>import ( "fmt" "log" "time"</p><pre class="brush:php;toolbar:false;">"github.com/jinzhu/gorm" _ "github.com/jinzhu/gorm/dialects/mysql" "github.com/astaxie/beego"
)
var DB *gorm.DB
func InitDB() { dsn := fmt.Sprintf( "%s:%s@tcp(%s:%s)/%s?charset=utf8mb4&parseTime=True&loc=Local", beego.AppConfig.String("db.username"), beego.AppConfig.String("db.password"), beego.AppConfig.String("db.host"), beego.AppConfig.String("db.port"), beego.AppConfig.String("db.name"), )
db, err := gorm.Open("mysql", dsn)
if err != nil {
log.Fatal("failed to connect database:", err)
}
// 开启日志（仅开发环境）
if beego.BConfig.RunMode == "dev" {
db.LogMode(true)
}
// 连接池配置
db.DB().SetMaxIdleConns(10)
db.DB().SetMaxOpenConns(100)
db.DB().SetConnMaxLifetime(10 * time.Minute)
// 全局复用
DB = db}
-
beego.AppConfig读取的是conf/app.conf里的配置项，别硬编码 DSN -
SetMaxIdleConns和SetMaxOpenConns必须显式设置，否则默认值（2 和 0）在生产环境完全不可用 - 不要在
init()函数里调用InitDB()，避免 import 循环；应在main.go的beego.Run()前手动调用
在 Controller 或 Service 中怎么安全使用 DB 实例
直接导入 models 包并使用 models.DB 即可，无需任何额外包装。GORM 的链式方法（如 Where、First、Preload）返回新实例，不影响原始 DB：
// controllers/user.go
func (c *UserController) Get() {
var user models.User
err := models.DB.Where("id = ?", c.Ctx.Input.Param(":id")).First(&user).Error
if err != nil {
c.Data["json"] = map[string]string{"error": "not found"}
c.ServeJSON()
return
}
c.Data["json"] = user
c.ServeJSON()
}
- 所有查询、更新、删除操作都基于
models.DB调用，不是新建实例 - 事务必须显式开启：用
tx := models.DB.Begin()，后续所有操作在tx上进行，最后tx.Commit()或tx.Rollback() - 不要把
models.DB当作参数传给函数——它本就是全局单例，传参反而增加理解成本和测试难度
迁移与模型定义要注意什么
GORM 的 AutoMigrate 只应在启动时执行一次（比如加个 if beego.BConfig.RunMode == "dev" 判断），且必须确保模型结构体字段已正确打 tag：
-
gorm.Model自带ID、CreatedAt、UpdatedAt、DeletedAt字段，若不用软删除，记得加gorm:"softDelete:false" - 外键关联要用
foreignKey+associationForeignKey显式声明，比如ProfileID uint `gorm:"index"`+Profile Profile `gorm:"foreignKey:ProfileID"` -
Preload默认不支持嵌套三层以上，深层关联建议拆成多次查询，避免 N+1 或笛卡尔积爆炸 - MySQL 5.7+ 默认 strict mode，
varchar字段长度必须明确指定，否则AutoMigrate会失败
最常被忽略的一点：GORM 实例一旦初始化，就不再响应配置文件热更新。改了 app.conf 里的数据库地址，不重启服务，models.DB 仍连着旧地址——它不是动态代理，只是个初始化后的连接池句柄。
