db.AutoMigrate() 不生效主因是字段缺GORM标签或类型不支持；应确保标签完整、ID显式声明、时间用time.Time；用HasTable检查存在性，开启日志排查；Echo中通过c.Set注入带上下文的*gorm.DB，避免全局实例并发问题。
为什么 db.AutoMigrate() 不生效或报错
常见现象是执行后表没创建，或者提示 "unsupported data type: invalid"。根本原因通常是结构体字段没加 GORM 标签，或类型不被 GORM 支持（比如自定义类型没实现 driver.Valuer 和 sql.Scanner）。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 确保每个字段都有
gorm标签，至少包含gorm:"column:name"或gorm:"primaryKey"等基础声明；id字段推荐显式写成gorm:"primaryKey;type:bigint"，避免 SQLite/MySQL 类型推导差异 - 时间字段统一用
time.Time，并加gorm:"autoCreateTime;autoUpdateTime"，别用int64或字符串模拟时间戳 - 运行
AutoMigrate前，先用db.Migrator().HasTable(&User{})检查是否已存在，避免重复迁移干扰判断 - 开发期开启 GORM 日志：
gorm.Config{Logger: logger.Default.LogMode(logger.Info)}，能看到实际执行的 SQL 和失败原因
如何在 Echo 的 echo.Context 中安全获取和复用 *gorm.DB
直接把全局 *gorm.DB 传进 handler 容易引发并发写 panic（比如误调 db.Session() 后又在其他 goroutine 里用原 db），也难做请求级上下文绑定（如自动注入 tenant_id）。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 用 Echo 的
c.Set("db", db.WithContext(c.Request().Context()))注入带请求上下文的实例，后续通过c.Get("db").(*gorm.DB)取出 —— 这样所有 DB 操作自动继承 HTTP 请求生命周期，超时、取消都能透传 - 不要在中间件里调
db.Begin()后塞进 context，事务必须由 handler 自己控制起止；中间件只负责注入「干净的、可复用的」db 实例 - 如果需要多库（如主从分离），用
db.Clauses(clause.Table{Expr: clause.Expr{SQL: "??", Vars: []interface{}{"slave_users"}}})动态切表，而不是维护多个全局 db 变量
db.First() 找不到记录时返回 ErrRecordNotFound，但 handler 总是 200
这是最常被忽略的逻辑漏洞：GORM 的 First、Take、Last 在无结果时不返回 error，而是返回 gorm.ErrRecordNotFound，但很多开发者只检查 err != nil，漏判这个特定错误。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 永远用
errors.Is(err, gorm.ErrRecordNotFound)判断「未找到」，而不是err == gorm.ErrRecordNotFound（因为可能被 wrapped） - 习惯性把查询封装成函数，例如：
func FindUserByID(db *gorm.DB, id uint) (*User, error) { var u User err := db.First(&u, id).Error if errors.Is(err, gorm.ErrRecordNotFound) { return nil, echo.NewHTTPError(http.StatusNotFound, "user not found") } return &u, err } - 别依赖
RowsAffected判定是否存在 ——First不影响它，Find才会更新该值
事务嵌套与 Echo 中间件配合的典型陷阱
想在 auth 中间件里开事务、handler 里 commit，结果 panic 报 "invalid transaction"。这是因为 GORM 的 Transaction 方法返回新 db 实例，原 db 不受影响，而中间件和 handler 拿到的仍是不同实例。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 事务必须在 handler 内部显式启动：
tx := db.Begin(); defer tx.RollbackUnlessCommitted()，中间件只负责鉴权、日志等无状态操作 - 若需跨多个 model 操作且保证原子性，把相关逻辑抽成函数，接收
*gorm.DB参数，由 handler 统一传入事务 db 实例 - 慎用
db.Session(&gorm.Session{AllowGlobalUpdate: true})—— 它绕过 GORM 的安全限制，在 Echo handler 中容易误删全表
真正麻烦的是关联预加载（Preload）+ 事务 + 分页组合场景，这时候 Count() 和 Find() 的事务隔离级别要一致，否则分页数对不上。这种细节没法靠框架自动兜底，得自己在 handler 里用同一个 tx 实例手动处理。
