database.yml 是 buffalo 数据库配置入口，但需配合 pop.connection 初始化、环境变量覆盖规则、手动设置连接池参数及多库场景下的定制化处理才能生效。
database.yml 是 Buffalo 项目中数据库配置的入口，但直接改它不等于生效——关键在 pop.Connection 初始化时机和环境加载逻辑。
database.yml 文件结构与环境变量覆盖
Buffalo 默认生成的 database.yml 放在 config/ 目录下，内容按环境分块（development、test、production）。每个块必须包含 dialect、database、user 等基础字段，否则 buffalo db migrate 会报 missing required field "dialect"。
环境变量可覆盖 YAML 值，优先级更高。例如：
-
DATABASE_URL=postgres://user:pass@localhost:5432/myapp?sslmode=disable会跳过database.yml解析，直接用于连接 -
DB_USER=myuser会覆盖database.yml中user字段（仅限字符串值，不支持嵌套）
注意：YAML 中的 pool 和 idle_timeout 不会被环境变量自动映射，必须显式写进 database.yml 或代码里初始化时传参。
pop.Connection 初始化位置与常见错误
Buffalo 的数据库连接由 pop.Connection 承载，通常在 models/models.go 的 init() 函数中调用 pop.Connect() 创建。这里容易出错的点：
- 没调用
db.Validate()—— 导致迁移或查询时才暴露连接失败，而不是启动时 - 硬编码了
"development"环境名，而实际运行用的是buffalo dev --env production，导致连错配置块 - 在
actions/app.go中重复初始化db，造成连接池泄漏（多个*pop.Connection实例共享同一连接池参数但未同步状态）
正确做法是只在 models/models.go 初始化一次，并导出为包变量供其他地方引用：
var DB *pop.Connection
<p>func init() {
var err error
DB, err = pop.Connect("development")
if err != nil {
log.Fatal(err)
}
DB.Validate()
}</p>
连接池参数如何生效
database.yml 中的 pool（最大连接数）和 idle_timeout（空闲连接超时）不会自动传给底层 sql.DB。Pop v2+ 要求你手动设置：
- 在
models/models.go初始化后立即调用DB.WithOptions(&pop.ConnectionOptions{...}) - 或更直接地：修改
DB.DB.SetMaxOpenConns(...)和DB.DB.SetConnMaxIdleTime(...)
例如：
DB.DB.SetMaxOpenConns(20) DB.DB.SetConnMaxIdleTime(5 * time.Minute)
不设的话，默认值由 Go 标准库决定（SetMaxOpenConns(0) 表示无限制），线上服务极易因连接耗尽挂掉。
多数据库场景下不能只靠 database.yml
Buffalo 的 pop 设计默认绑定单一数据库。如果你要对接微服务架构里的多个 DB（如 product_db 和 order_db），database.yml 无法原生支持多配置块切换。
可行路径只有两个：
- 放弃
buffalo db migrate，自己用pop.NewConnection()手动构造不同*pop.Connection实例，各自管理 migration 和事务 - 把
database.yml当模板，用 Go 代码读取并动态生成多个pop.Connection，但要注意pop.Transaction不支持跨连接嵌套
任何想靠 buffalo db migrate -e product 自动切库的操作都会失败——-e 只控制环境名，不控制连接目标。
Buffalo 的数据库配置表面简单，实则卡点密集：YAML 解析逻辑隐晦、环境变量覆盖规则不透明、连接池参数需手动透传、多库支持需绕开框架默认流程。最容易被忽略的是 DB.Validate() 缺失和 SetMaxOpenConns 未设，这两个问题在线上高并发时才会集中爆发。
