Iris中GORM必须全局单例初始化:在main()中调gorm.Open一次,配置db.DB().SetMaxOpenConns、SetMaxIdleConns、SetConnMaxLifetime,执行db.Ping()校验并AutoMigrate,最后通过app.RegisterValue注入容器供handler复用。

直接上结论:Iris 本身不管理数据库生命周期,gorm.DB 必须全局初始化一次、复用到底,不能在 handler 里反复 gorm.Open;连接池配置(如 SetMaxOpenConns)必须调在 db.DB() 返回的 *sql.DB 上,且只能设一次。
怎么在 main() 中初始化 GORM 并注册到 Iris 容器
错误做法是把 db 声明为包级变量后在每个 handler 里自己开连接,这会快速耗尽 MySQL 连接数。正确路径是在 main() 里完成连接、校验、连接池设置和自动迁移,再通过 app.RegisterValue 注入容器。
- 用
gorm.Open初始化*gorm.DB,dsn 字符串中必须带parseTime=true&loc=Local,否则时间字段解析出错 - 立刻调
db.DB()拿到底层*sql.DB,然后设SetMaxOpenConns(100)、SetMaxIdleConns(10)、SetConnMaxLifetime(1h)—— 这三行不能漏,也不能重复调 - 执行
db.AutoMigrate(&User{})(仅开发/启动期),线上环境建议用 SQL 迁移工具 - 最后调
app.RegisterValue(reflect.TypeOf(&gorm.DB{}), db),这样后续 handler 才能通过c.Get("gorm.DB")取到实例
handler 里怎么安全读取分页参数并传给 GORM
c.URLParam("page") 返回的是字符串,直接 strconv.Atoi 会 panic;更危险的是不校验范围,page=0 或 size=9999 可能触发全表扫描甚至 OOM。
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
- 一律用
c.URLParamInt("page")和c.URLParamInt("size"),它们返回(int, error),必须检查error - 手动约束值域:
if page ,<code>if size > 100 { size = 100 } - GORM 分页必须写成
db.Offset((page - 1) * size).Limit(size),顺序不能反;Limit().Offset()在旧版 GORM v1.21 之前有 SQL 生成 bug - 别拼 SQL 字符串传 offset,GORM 的
Offset/Limit是参数化执行,天然防注入
为什么 COUNT 查询总拖慢接口?怎么绕过
分页接口返回 total 很常见,但 SELECT COUNT(*) FROM ... JOIN ... WHERE ... 在复杂条件+多表关联时,MySQL 经常无法走索引覆盖,10w 行查一次可能 800ms+。
- 先用
EXPLAIN SELECT COUNT(*) ...看是否走了索引;没走就补联合索引,比如WHERE status = ? AND created_at > ?就建(status, created_at) - C 端列表优先考虑「下一页还有」模式,避免暴露精确 total;后台管理才需要精确值
- 如果真要 total 且查询极慢,可缓存它(比如每 5 分钟更新一次),或用近似统计(
SHOW TABLE STATUS的Rows字段,误差大但快) - 别在事务里跑 COUNT + 主查询,除非真需要强一致性;普通列表场景,两个查询独立执行即可
最易被忽略的一点:GORM v2 的 *gorm.DB 实例是协程安全的,但很多人误以为要每次 db.Session(&session) 隔离,结果徒增开销;普通查询直接用注册的全局 db 即可,只在显式事务或特殊上下文(如不同日志级别)时才需 Session。

















