buffalo框架中buffalo db仅负责数据库创建与迁移，不提供运行时crud能力；真正执行增删改查必须通过app.pop()获取pop.connection实例，并严格遵循模型定义、字段tag、tablename等约定，否则易出现panic或静默失败。
buffalo db create 和 migrate 只建表，不提供运行时查询能力
很多人以为 buffalo db 命令能直接执行增删改查，其实它只是迁移工具：只负责 create 数据库、migrate 表结构、rollback 版本。运行时的 CRUD 必须靠 pop.Connection 实例——它是真正封装了 PostgreSQL/MySQL/SQLite 驱动的查询入口。
常见错误现象：panic: connection is nil，通常是因为没调用 app.Pop() 就直接用了 Find 或 Save。
- 确保
app.go中已启用 pop（默认生成项目已配好） - 迁移前先跑
buffalo db create创建库，再buffalo db migrate - 别在模型里写裸 SQL —— pop 不解析字符串 SQL，它靠方法链和结构体映射
模型定义必须满足 pop 的硬性要求
pop 不是“自动适配型” ORM，字段映射、主键、表名全靠显式约定。缺一不可，否则 Save 失败、Load 返回空、关联静默丢数据。
典型问题：SQLite 下 Load 关联不生效，其实是外键约束默认关闭；PostgreSQL 插入时间字段报错，常因没声明 CreatedAt。
-
ID字段必须存在，类型为uint/int/string，且带db:"id"tag - 所有字段需加
db:"xxx"tag，否则 pop 当作忽略字段（写入 NULL） - 必须实现
TableName() string方法，返回复数形式（如"users"），否则找错表 - 时间字段建议显式声明
CreatedAt和UpdatedAt，pop 才会自动填充
action 中调用 app.Pop() 才是唯一安全路径
所有数据库操作都得从 app.Pop() 拿连接实例，不能自己 new、不能全局复用、不能跨请求传递。它内部做了连接池管理 + context 绑定 + error 分类，手动绕过等于放弃事务控制和上下文取消支持。
Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
容易踩的坑：在中间件或自定义函数里缓存 app.Pop() 结果，导致并发下连接错乱；用 pop.NewConnection 自己造连接，丢失应用级配置（如日志 hook、重试策略）。
- 创建：
err := app.Pop().Create(&u)，&u必须是指针 - 查询单条：
err := app.Pop().First(&u, "email = ?", "a@example.com") - 更新：先
First查出，改字段后调Save（不是Update） - 删除：
err := app.Pop().Destroy(&u)，传指针，且u.ID必须有值
事务必须用 pop.Transaction 显式包裹
别指望 HTTP handler 自动开事务。pop 默认每个方法都是独立语句，Create 和 Destroy 不在同一个事务里 —— 中间出错就回滚不了。
真实场景中，比如“创建用户 + 初始化配置记录”，两个 Create 必须原子化。用裸 Begin/Commit 容易漏 defer rollback，也难追踪 context cancel。
- 正确写法：
err := app.Pop().Transaction(func(tx *pop.Connection) error { ... }) - tx 里所有操作共享同一连接和事务上下文，return error 即自动 rollback
- 不要在 transaction 闭包外传
tx出去，它的生命周期只在此闭包内 - 嵌套 transaction 不起作用，pop 会降级为普通连接
最常被忽略的一点：pop 的 Load（预加载关联）依赖外键约束和显式 db: tag，SQLite 默认关外键，PostgreSQL 需提前建 foreign key。不验证这个，关联字段永远是零值，还查不出错。
