Buffalo框架本身不内置ORM,也不提供开箱即用的CRUD生成器,其设计哲学是“明确优于隐式”,默认仅负责路由分发、模板渲染和静态资源处理,数据库操作需开发者自行选型(如GORM、sqlx等)并手动实现模型、迁移与handler。

Buffalo 框架本身不内置 ORM,也不直接提供“开箱即用”的 CRUD 生成器——你得自己选数据库驱动、自己配模型层、自己写 handler。它更像一个轻量级 Web 路由+模板+生命周期协调器,不是 Rails 那种全栈封装体。
为什么 Buffalo 的 CRUD 不像 Laravel 或 Rails 那样一键生成
Buffalo 的设计哲学是“明确优于隐式”。它默认只做三件事:HTTP 路由分发、模板渲染(Plush)、静态资源处理。所有数据库操作都交由你决定:sqlx、gorm、ent,甚至裸 database/sql 都可以。这意味着:
- 没有
buffalo g model User name:string age:int这类命令(官方 CLI 不支持) - 没有自动生成的
CreateUserHandler或UserRepository - 迁移文件得用
buffalo pop(基于 Soda 库),但模型结构仍需手动定义
用 GORM 实现 User 表的增删改查(最常见组合)
这是目前 Buffalo 项目中落地最稳的方式。GORM 提供结构体映射、预加载、事务等能力,和 Buffalo 的 handler 生命周期能自然对齐。
实操步骤:
- 在
models/user.go中定义结构体,加gormtag:type User struct { ID uint `gorm:"primaryKey"` Name string `gorm:"not null"` Email string `gorm:"uniqueIndex;not null"` CreatedAt time.Time UpdatedAt time.Time } - 在
actions/users.go中写 handler,比如CreateUser:func CreateUser(c buffalo.Context) error { u := &models.User{} if err := c.Bind(u); err != nil { return err } tx := models.DB.Create(u) if tx.Error != nil { return tx.Error } c.Flash().Add("success", "User created") return c.Redirect(302, "/users/%d", u.ID) } - 路由必须显式注册:
app.Resource("/users", UsersResource{})或手写app.Post("/users", CreateUser)
Pop/Soda 迁移 + 手动模型同步容易踩的坑
Buffalo 自带的 pop 工具(Soda)负责迁移,但它和 GORM 的 struct tag 是两套体系,不会自动对齐。常见断裂点:
Buffalo框架 1.0.1 版本源码包下载,适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
-
pop create migration add_users生成的 SQL 文件里字段名是name,但 GORM struct 里写了Name string `gorm:"column:user_name"`→ 查询时字段找不到 - 迁移里设了
DEFAULT NOW(),但 GORM 的CreatedAt字段没加autoCreateTimetag → 新建记录时该字段为零值 -
pop migrate成功,但models.DB.AutoMigrate(&User{})被误留在代码里 → 启动时报错 “table users already exists”
删除操作必须处理外键与软删逻辑
Buffalo 默认不干预 DELETE 行为,但生产环境几乎从不真删。GORM 的软删依赖 gorm.DeletedAt 字段,而 Pop 迁移不会自动加这个列。
正确做法:
- 迁移文件里手动添加:
t.Column("deleted_at", "time", {"null": true}) - GORM 结构体加字段:
DeletedAt gorm.DeletedAt `gorm:"index"` - 查询时默认启用软删(GORM v2 默认开启),要查含已删记录得用
Unscoped() - 别在 handler 里写
DB.Delete(&u),改用DB.Unscoped().Delete(&u)真删,或留空让 GORM 自动处理
真正麻烦的从来不是写五个 handler,而是让迁移、模型、查询逻辑在多个地方保持一致。Buffalo 把控制权交给你,也把一致性责任交给你——它不帮你记哪条 SQL 对应哪个 struct tag,也不会在编译期告诉你 u.Email 在数据库里其实是 email_addr。










