buffalo框架中buffalo g model仅生成模型结构体和测试桩，不自动生成迁移文件；需额外执行buffalo g migration createusers创建fizz格式迁移文件，并确保database.yml配置正确、数据库服务运行正常。
Buffalo 框架本身不内置 ORM，但默认集成 pop（Buffalo 官方维护的数据库工具），项目开发中若跳过 pop 直接手写 SQL 或混用其他库（如 gorm），大概率会在迁移、事务、上下文绑定等环节出问题。
buffalo g model 生成的结构体为什么没进数据库？
常见现象：执行 buffalo g model User name:string email:string 后，models/user.go 有了结构体，但 buffalo db migrate 不生成表，或报错 no migration files found。
-
buffalo g model只生成模型定义和测试桩，不自动生成 migration 文件——必须额外运行buffalo g migration CreateUsers才会生成./migrations/xxx_create_users.up.fizz - 生成的
.up.fizz文件是 Buffalo 自研的 DSL 格式，不是纯 SQL；如果手动改成.sql后缀，buffalo db migrate就会跳过它 - 确保
database.yml中的development配置已正确填写，且 PostgreSQL/MySQL 服务正在运行；buffalo db create失败时不会报明显错误，但后续 migrate 必然失败
Pop 迁移里怎么加唯一索引或非空约束？
Fizz 语法比 raw SQL 更简洁，但字段修饰符容易漏写。比如要让 email 唯一且非空：
Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
create_table("users") {
t.Column("email", "string", {{"null", false}, {"unique", true}})
t.Column("name", "string", {"null", true})
}
注意：{"null", false} 和 {"unique", true} 是 map 形式，不是布尔字面量；写成 {null: false} 或 null: false 会解析失败，报错 unexpected token。
- 主键默认叫
id，类型为uuid（PostgreSQL）或integer（MySQL），不可改名；若需自定义主键，得在 Fizz 里显式声明t.PrimaryKey("my_id") - 时间戳字段（
created_at/updated_at）不会自动添加，必须在 Fizz 里手动写t.Timestamps() - 外键需用
t.ForeignKey("user_id", {"users", "id"})，不能只写表名；否则 migrate 会成功但数据库无外键约束
Handler 里怎么安全查数据并传给模板？
别直接在 HomeHandler 里用 db.Find(&u, id)——pop.Connection 不是全局单例，必须从 context 获取，否则并发下会 panic。
- 正确方式：用
c.Value("tx").(*pop.Connection)拿当前请求绑定的事务连接（Buffalo 在 middleware 里注入了它） - 查单条：用
tx.Find(&user, id)；查列表：用tx.All(&users)；带条件：用tx.Where("active = ?", true).All(&users) - 渲染前务必检查 error：比如
if err != nil { return c.Error(404, err) }；忽略err会导致模板收到零值结构体，前端看到空数据却无报错 - 模板里访问字段要小写首字母（Go 规则），比如
对应结构体字段Name string；写成name会渲染为空
真正容易被忽略的是：Buffalo 的 tx 默认开启事务，但如果你在 handler 里调用了多个 tx.* 方法，它们共享同一个事务上下文——一旦某步出错未 rollback，整个请求生命周期内该连接可能处于异常状态。生产环境建议对关键写操作显式用 tx.Transaction(func(tx *pop.Connection) error { ... }) 隔离。
