GORM在毕业设计中需规范使用：主键用int64或uint+autoIncrement，时间字段用time.Time加autoCreateTime/Update标签，字符串须指定size，软删除字段用*time.Time，AutoMigrate前手动校验/清理字段，CRUD务必传指针并开启日志，事务用db.Transaction封装防卡死。
gorm 在毕业设计项目里不是“要不要用”，而是“怎么用才不翻车”。它能省掉 70% 的 SQL 拼接和连接池管理，但新手常因模型定义错、迁移逻辑乱、事务漏 defer 或日志关太多，导致本地跑通、部署报 failed to connect database 或查不到数据却无报错。
模型字段标签写错，AutoMigrate 不建表或字段类型不对
毕业设计常见错误：直接复制网上的 type User struct { ID uint `gorm:"primaryKey"` }，但没注意 MySQL 默认引擎是 InnoDB，而 uint 对应的 UNSIGNED INT 在某些低版本 MySQL（如 5.7）上可能触发 invalid field tag 或建表失败。
实操建议：
- 主键统一用
int64或uint+gorm:"primaryKey;autoIncrement"，避免隐式转换问题 -
CreatedAt/UpdatedAt字段必须是time.Time类型，并显式加gorm:"autoCreateTime;autoUpdateTime"标签，否则AutoMigrate不会自动设默认值 - 字符串字段务必指定
size，比如Name string `gorm:"size:32;not null"`；不写 size 时 GORM V2 默认生成varchar(255)，可能超出学校数据库配额（尤其共享 MySQL 实例） - 软删除字段
DeletedAt必须用*time.Time（指针），且加gorm.DeletedAt标签，否则db.Unscoped().Where(...)无效
db.AutoMigrate(&User{}) 后表没更新，或者字段被删了
这是毕业设计最扎心的问题：改了结构体字段，AutoMigrate 却没生效，甚至把已有字段干掉了。根本原因是 AutoMigrate 只做“增”和“改”，不做“删”——但它也不会报错，静默跳过。
实操建议：
- 开发阶段每次改模型后，先手动执行
db.Migrator().DropColumn(&User{}, "old_field_name")再AutoMigrate，避免残留字段干扰 - 严禁在生产环境（哪怕是毕设演示服务器）直接跑
AutoMigrate；应导出 SQL 迁移语句，人工审核后执行 - 用
db.Migrator().HasColumn(&User{}, "email")做存在性校验，比靠日志猜更可靠 - 如果用了
gorm.Model(&User{})配合Table("users")自定义表名，AutoMigrate仍会作用于该表，但必须确保结构体字段与Table()名一致，否则建错表
CRUD 写法看着对，但查不到数据也不报错
典型现象：db.First(&u, 1) 返回 nil 错误，但 u 里字段全是零值；或 db.Where("name = ?", "张三").Find(&users) 查出来空切片，日志里却没打印 SQL。
原因多为：软删除未关闭、扫描目标非指针、日志被关、或 WHERE 条件字段名和结构体字段名不一致（比如数据库是 user_name，结构体写成 UserName 却没加 gorm:"column:user_name"）。
实操建议：
- 调试期必开日志：
gorm.Config{Logger: logger.Default.LogMode(logger.Info)}，否则所有 SQL 都看不到 -
Find/First的第二个参数必须是指针（&users或&u），传值会导致内存拷贝失败 - 查软删除数据，必须显式调用
db.Unscoped().Where(...).Find(&users)，Unscoped不能漏 - 用
db.Debug().Where(...).Find(...)临时打开调试模式，强制打印 SQL 和参数，比加断点快得多
事务没提交，或 panic 后没回滚
毕设里常见伪事务代码：tx := db.Begin(); tx.Create(...); tx.Commit()，但中间任何一行 panic，Commit 就不会执行，连接还卡在事务中，后续请求全卡住。
实操建议：
- 必须用
defer+recover保证回滚：tx := db.Begin() defer func() { if r := recover(); r != nil { tx.Rollback() } }() if err := tx.Create(&u).Error; err != nil { tx.Rollback() return err } return tx.Commit().Error - 更稳妥的做法是封装成函数：
db.Transaction(func(tx *gorm.DB) error { ... })，GORM V2 内置该方法，panic 时自动回滚 - 事务内不要调用外部 HTTP 请求或文件 IO，毕设演示环境网络不稳定，超时容易导致事务长时间悬挂
- MySQL 默认隔离级别是
REPEATABLE READ，毕设若做库存扣减类逻辑，记得显式设tx.Session(&gorm.Session{PrepareStmt: true})防止预编译失效
毕业设计真正难的不是语法，是让整套流程在答辩前半小时还能稳定跑通——模型字段对齐、迁移可控、查询可 trace、事务不卡死。这些点漏一个，就可能让演示变成“正在加载…”，而不是“已成功提交”。
