gorm.Open 一调就 panic 的根本原因是传参方式错误：GORM v2 不再支持 gorm.Open("mysql", dsn)，必须先用驱动的 Open 函数（如 mysql.Open(dsn)）获取 *sql.DB，再传入 gorm.Open。
gorm.Open 为什么一调就 panic
根本原因不是 DSN 写错，而是传参方式错误：GORM v2 不再接受 gorm.Open("mysql", dsn) 这种双字符串参数写法，会直接触发 panic: unsupported driver。
必须先用对应驱动的 Open 函数获取 *sql.DB，再传给 gorm.Open：
- MySQL：导入
gorm.io/driver/mysql，调用mysql.Open(dsn) - PostgreSQL：导入
gorm.io/driver/postgres，调用postgres.Open(dsn) - SQLite：导入
gorm.io/driver/sqlite，调用sqlite.Open("test.db")
示例（MySQL）：
import (
"gorm.io/driver/mysql"
"gorm.io/gorm"
)
dsn := "user:pass@tcp(127.0.0.1:3306)/dbname?charset=utf8mb4&parseTime=True&loc=Local"
db, err := gorm.Open(mysql.Open(dsn), &gorm.Config{})
AutoMigrate 为什么没建表或字段缺失
AutoMigrate 不是“同步 schema”，它只做单向增量：新增表、新增字段、新增索引，但绝不会删字段、改类型、重命名列。一旦执行过，就别指望它回退。
立即学习“go语言免费学习笔记（深入）”；
常见漏点：
- 首字母小写的 struct 字段（如
name string）默认被 GORM 忽略，必须加gorm:"column:name"显式声明 - 字段类型不匹配（如 struct 用
int64，DB 列是BIGINT UNSIGNED），AutoMigrate会静默跳过该字段 - 外键关联字段类型不一致（如
UserID uint对应 DB 中INT），MySQL 8.0+ 严格模式下迁移失败但无报错，需开启日志：gorm.Config{Logger: logger.Default.LogMode(logger.Info)}
Where 传 map 或 struct 总是查不到数据
GORM 对 Where 的 map / struct 解析不做零值过滤 —— ""、0、nil 都会被当有效条件生成 SQL。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
例如：Where(map[string]interface{}{"name": "", "age": 0}) 实际生成：WHERE name = '' AND age = 0，而非“忽略空值”。
安全做法：
- 手动链式拼接：
Where("name != ?", "").Where("age > ?", 0) - struct 传参更危险：字段名必须与 DB 列名**完全一致（含大小写）**，
gorm:"column:user_name"不影响Where(&User{Name: "a"})的解析逻辑 - 需要动态条件时，优先用
map[string]interface{}+ 显式判断，而不是依赖结构体自动展开
分表场景下 TableName() 为什么总查错表
TableName() 是实例级静态方法，模型初始化时就被缓存。一旦注册多个分表（如 user_001、user_002），GORM 内部 schema 缓存会冲突，导致查询总是落到第一个注册的表上。
典型现象：record not found 或查到其他分表的数据；用 db.Table("user_002").Where().Find() 能绕过但破坏 ORM 抽象，后续关联、钩子、软删除全失效。
正确做法是用 Scopes 封装分表逻辑：
- 把分片键（如
userID）作为参数传入 scope，不能从context或全局变量读 —— 否则并发下错表 - scope 必须返回
*gorm.DB，不能直接db.Table().Where()链式调用后返回结果 - 别在 scope 里做
db.Unscoped()或改FullSaveAssociations，这些会污染后续链式操作
分表决策必须发生在 query 构建早期，且依赖明确输入 —— hook 拿不到原始 SQL 条件里的分片键值，靠“猜”WHERE 条件不可靠。
