gorm.Open() 本身不 panic，常见 panic 根源是未导入驱动（如 _ "github.com/go-sql-driver/mysql"）导致 sql.Register 失败，进而触发 "driver: unknown driver" panic；必须显式下划线导入驱动并检查 err。
为什么 gorm.Open() 会 panic 而不是返回 error？
因为 gorm.Open() 在 v2 版本中设计为只返回 error，不 panic；但很多人实际遇到 panic，根本原因是没处理好驱动初始化——比如用 mysql 驱动却没导入 _ "github.com/go-sql-driver/mysql"。GORM 本身不自带驱动，靠 blank import 触发驱动的 init() 函数注册到 sql.Register。漏掉这行，gorm.Open() 就会报 "driver: unknown driver \"mysql\"" 并 panic。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 确保在 main 包或初始化文件里显式导入驱动：
_ "github.com/go-sql-driver/mysql"（MySQL）或_ "github.com/lib/pq"（PostgreSQL） - 连接字符串必须包含参数，例如
parseTime=true&loc=Local，否则时间字段可能解析失败或时区错乱 - 不要直接传裸字符串给
gorm.Open()，先用sql.Open("mysql", dsn)测试能否建连，避免 GORM 延迟报错掩盖问题
如何让 Gin 的请求生命周期安全使用 GORM DB 实例？
Gin 的 *gin.Context 不该存全局 *gorm.DB，也不该每次请求都 gorm.Open()。正确做法是复用一个已配置好的 *gorm.DB 实例，并通过中间件注入上下文，或直接作为依赖传入 handler。GORM 实例本身是并发安全的，但要注意事务隔离。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 在应用启动时调用
gorm.Open()一次，得到*gorm.DB，然后用db.WithContext(c.Request.Context())绑定 Gin 请求上下文，便于超时控制和取消 - 需要事务时，用
db.Transaction(func(tx *gorm.DB) error { ... })，别手动Begin()/Commit()，否则容易漏 rollback - 避免在中间件里用
c.Set("db", db)然后 handler 里强转——类型不安全，改用结构体封装或依赖注入更可靠
db.First() 查不到记录时返回什么？怎么判断“没找到”？
db.First(&user, 1) 查不到主键为 1 的记录时，不会 panic，但返回的 error 是 gorm.ErrRecordNotFound，不是 nil。很多人直接判 err != nil 就认为出错了，其实这是正常业务分支。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 显式检查错误类型：
errors.Is(err, gorm.ErrRecordNotFound)，而不是err == gorm.ErrRecordNotFound（因底层可能 wrap） - 用
db.Unscoped().First()可绕过软删除（DeletedAt），但多数场景应尊重软删除逻辑 - 如果想统一处理“未找到”，可封装一层：
func FindUser(db *gorm.DB, id uint) (*User, error) { ... }，内部处理ErrRecordNotFound并返回自定义 error 或 nil
连接池设置不当会导致 Gin 接口超时或数据库拒绝连接
GORM 默认的连接池参数极保守：最大空闲连接数 2，最大打开连接数 0（即不限制），但 MySQL 默认最大连接数常为 151。高并发下容易打满数据库连接，或因空闲连接太少导致请求排队。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 务必配置连接池：
db.DB().SetMaxIdleConns(10)、db.DB().SetMaxOpenConns(100)、db.DB().SetConnMaxLifetime(time.Hour) -
SetConnMaxLifetime很关键——不设的话，长连接可能因网络中断或数据库重启而僵死，GORM 不会自动重连 - 用
db.DB().Ping()在启动时验证连通性，比等第一个请求失败再报警更主动
最常被忽略的是连接池参数和驱动导入这两处；一旦线上出现“too many connections”或“driver: unknown driver”，基本就在这两个地方找。
