需全局复用sql.DB实例，于main中初始化并调用app.RegisterValue注册至Iris容器，handler中通过c.Get获取；分页参数须用URLParamInt校验，GORM分页用Offset((page-1)size).Limit(size)，COUNT查询应建联合索引或缓存。
怎么初始化 GORM 并注入 Iris 应用上下文
不能让每个 handler 都去 gorm.Open 一次，得全局复用一个 *gorm.DB 实例，并确保它被正确传入 Iris 的依赖注入或请求上下文。Iris 本身不管理 DB 生命周期，你得自己 hold 住。
常见错误是把 db 声明为包级变量但没做并发安全处理——GORM v2 的 *gorm.DB 实例是协程安全的，但连接池配置（如 SetMaxOpenConns）必须在 db.DB() 返回的 *sql.DB 上调用，且只能调一次。
- 在
init()或main()中完成数据库连接、连接池设置和自动迁移 - 用
app.RegisterValue(reflect.TypeOf(&gorm.DB{}), db)注册到 Iris 容器，后续 handler 可通过c.Get("gorm.DB")获取 - 别在 handler 里重复调
db.Session()除非真需要隔离事务；普通查询直接用注册的全局db - 如果用了
gorm.Config{PrepareStmt: true}，注意 MySQL 8.0+ 才完全支持预编译语句缓存
怎么在 Iris handler 中安全读取分页参数并传给 GORM
Iris 不解析 query 参数为整型，c.URLParam("page") 返回的是字符串，直接转 int 可能 panic。更糟的是，若没校验范围，page=0 或 size=10000 会触发全表扫描或 OOM。
- 用
c.URLParamInt("page")和c.URLParamInt("size")，它们返回(int, error)，必须检查 error - 手动约束：page 至少为 1，size 建议上限设为 100（
if size > 100 { size = 100 }） - GORM 分页写法固定：
db.Offset((page - 1) * size).Limit(size)，不是Limit(size).Offset(...)—— 后者在某些旧版 GORM 中顺序错会导致 SQL 错误 - 别拼接 offset 值进 SQL 字符串，哪怕已转 int；GORM 的
Offset/Limit是参数化执行，天然防注入
为什么 COUNT 查询总比主查询慢，怎么避免拖垮接口
分页必须返回 total，但 SELECT COUNT(*) FROM ... WHERE ... 和主查询条件一致时，如果带 JOIN 或子查询，MySQL 可能无法用索引覆盖，导致全表扫描。线上查 10w 行可能耗时 800ms+。
- 先确认是否真需要精确 total：后台管理可接受，C端列表建议用「下一页还有」代替页码跳转
- 对复杂条件，用
EXPLAIN SELECT COUNT(*) ...看是否走了索引；没走就补联合索引，比如WHERE status = ? AND created_at > ?就建INDEX(status, created_at) - 缓存 count 结果：Redis 存
count:users:active，过期时间设为 5–30 分钟，更新用户状态时异步刷新 - 避免在事务里查 count —— 长事务会让 count 持有 MVCC 快照，加剧锁竞争
怎么处理 GORM 关联查询与 Iris JSON 序列化冲突
GORM 的 Preload 或 Joins 加载关联字段后，结构体嵌套容易引发无限递归（比如 User → Posts → User），Iris 默认用 Go 标准库 json.Marshal，遇到循环引用直接 panic。
- 在 model struct 的 JSON tag 里加
omitempty和-控制输出，例如：Posts []Post `json:"posts,omitempty"`，User User `json:"-"`在 Post 里 - 不要用
db.Preload("Posts").Find(&users)后直接c.JSON(200, users)，先转成 DTO（如UserDTO）再序列化 - 如果用了
gorm.Model(&u).Select("name,email").First(&u)这种字段筛选，注意 GORM v2 不会自动忽略未 select 的字段——JSON 还是会输出零值，得靠 tag 控制 - 启用 GORM 的
DisableForeignKeyConstraintWhenMigrating可避免外键干扰 preload，但上线前务必关掉，否则数据一致性无保障
GORM 和 Iris 整合最易被忽略的点是连接池配置时机和 count 查询的性能陷阱——前者错一次，整个服务连接耗尽；后者不压测，上线后分页接口直接超时。
