必须显式安装驱动、空导入、严格匹配dialect名，三者缺一不可，否则buffalo db migrate报unknown dialect或driver；database.yml中dialect仅支持postgres、mysql、sqlite3、cockroach；models/models.go需空导入对应驱动包；pop字段映射依赖db标签；连接池参数须在go代码中调用setmaxopenconns等方法设置。
必须显式安装驱动、空导入、严格匹配dialect名，三者缺一不可，否则buffalo db migrate直接报unknown dialect或driver: unknown driver。
database.yml里dialect写错是最常见的连接失败原因
Pop只认四个字符串：postgres、mysql、sqlite3、cockroach。写成postgresql、pgsql、mariadb、sqlite全都会失败——错误不是“连不上”，而是“根本找不到驱动”。
确认方式：打开database.yml，development节下dialect字段值必须一字不差地等于上述其一。
models/models.go里没空导入驱动包就等于没装
Buffalo生成的models/models.go默认只import了github.com/gobuffalo/pop/v6，但没import具体数据库驱动。Go的sql.Register依赖包被import才会触发初始化，否则pop调用sql.Open时找不到对应driver。
实操建议：
- PostgreSQL：在
models/models.go顶部加_ "github.com/lib/pq" - MySQL：加
_ "github.com/go-sql-driver/mysql" - SQLite3：加
_ "github.com/mattn/go-sqlite3"
加完立刻执行go mod tidy，确保go.sum里出现对应驱动版本。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
Pop模型结构体字段和数据库列名不一致会导致Find/All返回零值
Pop默认按结构体字段名映射列名（snake_case），比如UserID uint会去找user_id列。但如果数据库列是uid或user_id_int，Pop不会自动转换，也不会报错，只是把字段设为零值。
解决方法：
- 用
db标签显式指定：UserID uint `db:"uid"` - 外键字段名必须与关联表实际列名完全一致，否则
Eager()加载为空 - 时间字段推荐用
time.Time类型，Pop能自动处理created_at/updated_at，但deleted_at需手动参与WHERE条件（Pop不内置软删除）
连接池参数不在database.yml里配，得改Go代码
Pop不解析database.yml里的max_open_connections或max_idle_connections。这些参数必须在models/models.go中调用pop.Connection#SetMaxOpenConns()等方法显式设置。
典型写法：
func init() {
// ... 其他初始化
if err := db.Connection.SetMaxOpenConns(25); err != nil {
log.Fatal(err)
}
db.Connection.SetMaxIdleConns(20)
}
不设的话，Go database/sql默认MaxOpenConns=0（无限制），在高并发下容易打爆数据库连接数。
最容易被忽略的是：即使database.yml语法全对、驱动也import了，只要go mod tidy没跑成功，或者buffalo db create时用户没CREATEDB权限，后续所有操作都会卡在初始化阶段，错误信息却只显示泛泛的failed to open connection——得盯住app.Pop()调用栈最底层的真实error。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
