Buffalo的Action函数必须是func(c buffalo.Context) error类型，返回error（成功时为nil），否则路由注册失败；需用c.Bind(&u)绑定数据并手动校验，调用c.Render()前须c.Set("user", &u)，启用app.PrecompileTemplates()可提前发现模板字段错误。
怎么写一个能被路由调用的Action函数
Buffalo 的 Action 函数必须是 func(c buffalo.Context) error 类型，且不能带额外参数或返回值。它不是普通 Go 函数，而是框架约定的入口签名，否则 app.GET("/users/new", UsersNew) 会编译失败或 panic。
常见错误现象：写成 func UsersNew(c buffalo.Context) {}（无返回值）、func UsersNew(w http.ResponseWriter, r *http.Request)（HTTP 原生签名）或 func UsersNew(c buffalo.Context, id int) error（多参数）——这些都会导致路由注册失败或运行时报 cannot use ... as buffalo.Handler。
- 必须返回
error：即使逻辑成功，也要返回nil；返回非nilerror 会触发全局错误中间件（如渲染errors/500.html） - 函数名不重要，但建议按约定命名（如
UsersNew、PostsCreate），便于团队识别意图 - 不要在 Action 里直接操作
http.ResponseWriter或调用http.Error，要用c.Render()、c.Redirect()或c.Error()
如何安全地从请求中取数据并绑定到结构体
c.Bind(&u) 是最常用方式，但它只做基础映射，不校验字段是否存在或类型是否匹配。如果表单字段名和结构体 tag 不一致（比如缺 form:"email"），Bind 会静默跳过该字段，导致 u.Email 为空但没报错。
正确做法是：先声明结构体变量，再传地址给 Bind，最后手动检查关键字段：
u := User{}
if err := c.Bind(&u); err != nil {
c.Set("user", &u)
c.Set("errors", map[string]string{"email": "格式不合法"})
return c.Render(422, r.HTML("users/new.html"))
}
// 再做业务级检查
if u.Email == "" {
u.AddError("email", "邮箱不能为空")
}
if u.Password != u.PasswordConfirm {
u.AddError("password_confirm", "两次输入不一致")
}
-
Bind不会自动调用Validate()方法，得自己显式调用validate.Validate(&u) - 结构体字段必须有
form:"xxx"tag 才能被映射，例如Name string `form:"name"` - 别用
new(User)后再传&*u，容易因零值问题导致绑定失败
为什么调用了 c.Render() 却返回空白页或 500
最常见原因是模板路径写错，或者模板里引用了不存在的字段。Buffalo 不会在编译期检查 {{.user.Email}} 中的 Email 是否真在结构体上，直到渲染那一刻才 panic。
Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
解决办法分两层：
- 开发阶段启用
app.PrecompileTemplates()（加在app.go的App()函数里），它会在buffalo dev启动时扫描所有templates/下的文件，提前报出unknown field "Email" in struct - 确保
c.Set("user", &u)在Render前执行，且u是已初始化的变量（不是nil指针） - 模板中用
{{if .FormErrors.email}}{{.FormErrors.email}}{{end}}渲染错误，而不是直接读.user.email（因为绑定失败时.user可能为nil）
数据库操作该放哪、怎么捕获错误
Action 里查单条用 tx.Find(&u, id)，不是 First——pop 没有 User.First() 这种方法，硬写会编译失败。查不到时返回 pop.ErrRecordNotFound，不是 nil 错误。
写入失败时，validate.Validate(&u) 通过不代表 DB 能成功，比如邮箱重复会触发 PostgreSQL 的 UNIQUE 约束错误，错误信息类似：ERROR: duplicate key value violates unique constraint "users_email_key"。
- 查单条后必须检查
errors.Is(err, pop.ErrRecordNotFound)，再决定返回 404 还是继续 - 创建前可加一层 DB 校验：
tx.Where("email = ?", u.Email).First(&existing)，避免靠pop.Create失败后再解析错误字符串 - 别在 Action 里手动
defer tx.Close()，Buffalo 的 pop 中间件已管理事务生命周期
真正容易被忽略的是：Action 函数里所有对 c.Value("tx") 的断言（如 tx, ok := c.Value("tx").(*pop.Connection)）都必须检查 ok，否则线上环境遇到中间件异常时可能 panic 而不是返回 500。
