Buffalo 的 pop ORM 不支持在 database.yml 中直接配置 maxIdleTime，必须在应用启动后手动调用 sql.DB.SetConnMaxIdleTime() 设置；该配置不影响 buffalo db migrate，且需确保其值不超过 MySQL 的 wait_timeout。
buffalo db 连接池不直接暴露 maxIdleTime 参数
Buffalo 默认用 pop ORM 管理数据库连接，而 pop 底层依赖 Go 的 database/sql，但它的配置层（如 database.yml）**不支持直接设置空闲连接最大保留时间（max idle time）**。这个参数实际由 sql.DB.SetConnMaxIdleTime() 控制，但 pop.Connection 没有提供对应字段或钩子。
必须手动 patch pop.Connection 的 DB 实例
你得在应用启动后、首次使用数据库前，拿到底层 *sql.DB 并调用 SetConnMaxIdleTime()。常见位置是 actions/app.go 里 app.Use(popmw.Transaction(models.DB)) 之前：
// 在 models/models.go 初始化后，显式设置
models.DB.RawQuery("SELECT 1").Exec() // 触发 DB 初始化
if db, ok := models.DB.DB(); ok {
db.SetConnMaxIdleTime(5 * time.Minute) // 关键：设为空闲 5 分钟即回收
}- 必须等
models.DB真正初始化完成（比如执行一次 dummy query），否则models.DB.DB()返回 nil - 该设置只影响空闲连接的存活时长，不影响
SetMaxOpenConns或SetMaxIdleConns - MySQL 驱动本身不校验该值，但底层
database/sql会在连接空闲超时后自动 close 它
注意 MySQL server 端 wait_timeout 的协同
如果 MySQL 服务端的 wait_timeout（默认 8 小时）比你的 SetConnMaxIdleTime() 小，连接可能在被客户端回收前就被服务端主动断开，导致下次复用时报 invalid connection 错误。建议：
Buffalo框架 1.0.1
下载
Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
- 查当前 MySQL 设置：
SHOW VARIABLES LIKE 'wait_timeout'; - 确保代码中
SetConnMaxIdleTime()值 ≤wait_timeout - 30s（留安全余量） - 若无法改 MySQL 配置，可配合
SetConnMaxLifetime()强制定期刷新连接
buffalo db migrate 不受此配置影响
buffalo db migrate 是独立 CLI 工具，它绕过应用中的 models.DB 实例，直接读 database.yml 并新建 *sql.DB。所以你在代码里设的 SetConnMaxIdleTime() 对迁移命令无效。如需统一控制，得在 database.yml 里加 URL 参数（仅部分驱动支持）：
development: dialect: mysql database: myapp_development host: 127.0.0.1 port: 3306 user: root password: "" # 注意：mysql-go 驱动不识别 maxIdleTime，但 pgx/pgdriver 支持 `maxConnLifetime` 参数 url: "mysql://root@127.0.0.1:3306/myapp_development?parseTime=true&loc=Local"
真正起效的只有手动 patch *sql.DB 这一条路——因为 Buffalo 的 pop 层把连接池细节锁死了，没留配置口子。
