GORM上线前panic多因类型错误、连接池未配置和时间解析失败：必须用*gorm.DB接收gorm.Open()返回值，DSN加parseTime=true，连接池参数需显式设置。
别让 GORM 在上线前半小时突然 panic —— 大部分“诡异问题”都来自类型、连接池和时间处理这三处，不是逻辑写错了，是初始化没对。
gorm.Open() 返回值必须用 *gorm.DB 接收，否则后续所有操作都可能静默失败
编译报错 cannot assign *gorm.DB to dc.DB (type gorm.DB) 是最典型的信号。这不是 DSN 写错，而是 Go 类型系统在拦你：GORM v2 的 gorm.Open() 永远返回 *gorm.DB，而你在结构体里声明的是 gorm.DB（值类型）。值类型会浅拷贝内部的连接池、回调栈和日志器，导致 db.Create() 看似成功，实际连不上库；事务里 db.Transaction() 也可能不生效。
- 结构体字段必须声明为
DB *gorm.DB，不是DB gorm.DB - 所有 getter 方法（如
GetDB()）返回类型也得是*gorm.DB - 全局只调用一次
gorm.Open()，用sync.Once包裹，不要每次请求都 new - 别信“先跑通再说”，这个类型错误一旦漏掉，后期排查成本远高于初始化时多敲两个星号
DSN 必须带 parseTime=true，否则 time.Time 字段永远是零值
MySQL/PostgreSQL 的 DATETIME 字段默认被 database/sql 当成字符串解析，parseTime=true 才触发 time.Time 转换。不加它，CreatedAt 和 UpdatedAt 看起来没报错，但查出来全是 0001-01-01 00:00:00 +0000 UTC，且无任何 warning。
- 典型 DSN：
user:pass@tcp(127.0.0.1:3306)/dbname?charset=utf8mb4&parseTime=true&loc=Asia/Shanghai -
loc=Asia/Shanghai显式指定时区，避免服务器 UTC 时区导致时间错位 - SQLite 和 SQL Server 驱动忽略该参数，不用硬加；达梦 DM8 需确认驱动版本是否支持
parseTime - 软删除字段
DeletedAt gorm.DeletedAt同样依赖此参数，否则Unscoped().Where("deleted_at IS NOT NULL")查不到数据
连接池参数不设等于没连数据库
defer db.Close() 只关底层 *sql.DB，但 GORM 实例仍持有失效指针；更危险的是，默认 MaxOpenConns = 0（无限），高并发下 MySQL 直接报 Too many connections。
- 必须在
gorm.Open()后立刻设置：db.DB().SetMaxOpenConns(20)、db.DB().SetMaxIdleConns(10)、db.DB().SetConnMaxLifetime(60 * time.Minute) -
MaxOpenConns建议设为数据库max_connections的 70%～80%，起步可设 10–30，压测后再调 - 事务开启后必须显式
Commit()或Rollback()，漏一个，连接就永久卡在InUse状态，db.Stats()里Idle == 0且WaitCount持续上涨就是征兆 - 别依赖“自动回收”——防火墙、中间件静默断连时，
SetConnMaxLifetime是唯一兜底手段
原子更新必须用 gorm.Expr()，别在代码里算完再 Save()
库存扣减、积分变更等场景，用 First → 计算 → Save 模式必然超卖。并发请求读到同一初始值，各自减一再写回，结果只扣了一次。
- 正确写法：
db.Model(&product).Update("stock", gorm.Expr("stock - ?", 1)) - 支持复杂表达式：
gorm.Expr("total * ? + ?", 0.9, 5)，全部在数据库端执行 - 子查询更新也靠它：
db.Model(&user).Update("company_name", db.Model(&Company{}).Select("name").Where("companies.id = users.company_id")) - 注意：Expr 不做参数校验，拼错 SQL 会直接报错，建议单元测试覆盖关键路径
真正难调试的从来不是语法错误，而是那些“看起来正常却不对”的行为——比如时间字段全为零、事务不回滚、连接数缓慢爬升。这些问题的根因往往藏在初始化那几行代码里，而不是业务逻辑深处。
