必须先初始化gorm.DB并注册到Iris容器，再注册控制器；控制器中字段需声明为DB gorm.DB（指针类型、首字母大写），Iris自动注入，类型不匹配或注册顺序错误将导致panic。
怎么在Iris MVC中注入已初始化的*gorm.DB
必须先完成数据库连接初始化，再注册到Iris依赖容器，否则控制器字段注入会失败并panic。Iris不会帮你自动创建或管理DB实例，它只负责按需传递已注册的对象。
-
GetDB()函数返回的*gorm.DB必须在app := iris.New()之前调用过，确保全局变量db已赋值 - 注册时不能传值类型（如
db），而应传函数或指针：app.Register(func() *gorm.DB { return GetDB() }) - 若用
app.Singleton[*gorm.DB](func() *gorm.DB { return GetDB() })更清晰，明确表达单例语义 - 注册顺序很重要：DB必须在控制器注册前完成，否则
app.RegisterController[UserController]()会因找不到依赖而报错 “no dependency found for type”
控制器里怎么声明和使用DB字段
Iris MVC支持结构体字段自动注入，但标签和类型写法有硬性要求——写错一个字符就会导致注入失败，且无编译错误，只有运行时panic。
- 字段类型必须与注册类型完全一致：
DB *gorm.DB，不能是*sql.DB或gorm.DB（非指针） - 字段名大小写敏感，推荐首字母大写（
DB），小写字段（如db）默认不可导出，无法被反射注入 - 无需加
inject:""标签——Iris 12.2.5+ 版本已默认启用字段自动注入，加了反而可能干扰 - 示例结构体：
type UserController struct { iris.Controller DB *gorm.DB }
为什么DB查询在控制器方法里总返回空或panic
常见原因不是SQL写错，而是上下文生命周期或连接配置没对齐。GORM的 *gorm.DB 实例本身不保存连接状态，真正起作用的是底层 *sql.DB 的连接池设置。
- 检查
init()中是否调用了sqlDB.SetMaxIdleConns(10)等配置——漏掉会导致高并发下连接耗尽，表现为随机超时或connection refused - 不要在控制器方法里重复调用
db.Session(&gorm.Session{})创建新会话，除非真需要事务隔离；多数场景直接用注入的c.DB即可 - GORM v2 默认启用 prepare statement，MySQL 8.0+ 需确认服务端未禁用
prepare_stmt，否则首次查询会 panic 报ERROR 1235 (42000): This version of MySQL doesn't yet support 'Prepared statements' - 调试时可在方法开头加
if c.DB == nil { panic("DB is nil") }快速定位注入失败点
要不要把DB封装成Repository接口再注入
可以，但没必要一开始就抽象。Iris MVC的字段注入机制对具体类型友好，强行套接口反而增加维护成本，尤其当团队小于5人、接口数少于50个时。
- 如果已有
UserRepository接口和*UserRepo实现，注册方式为：app.Register((*UserRepo)(nil))—— 注意必须传空指针，不能传&UserRepo{} - 控制器字段写成
Repo UserRepository，Iris能自动匹配实现类型 - 但要注意：GORM 的链式调用（如
Where().First()）返回新*gorm.DB实例，不是原对象，所以 Repository 方法内部仍要接收*gorm.DB作为参数，或闭包捕获 - 更轻量的做法是直接注入
*gorm.DB，在 controller 方法内组织查询逻辑，等业务复杂度上升后再拆出 service 层
SetConnMaxLifetime 没设或设得太短，导致连接被 MySQL 主动断开后未及时清理。 
