Buffalo中获取query和form参数须先调用c.Request().ParseForm()，之后c.Param("key")才可 fallback 获取查询或表单值；multipart/form-data需改用ParseMultipartForm并设内存阈值。
Buffalo 中获取 query 和 form 参数的正确方式
Buffalo 默认使用 net/http 底层，但参数解析不自动完成——你必须显式调用方法，否则 c.Param() 或 c.Params() 只能拿到路由路径参数，拿不到 URL 查询串或表单数据。
常见错误现象：访问 /search?q=go&limit=10，却在 handler 里打印出空字符串或 panic；或者 POST 表单提交后 c.Param("username") 始终返回空。
-
c.Param("name")只用于匹配路由中定义的命名段，例如r.GET("/users/:id", handler)中的:id - URL 查询参数（
?key=value）必须用c.Param("key")—— 等等，不对！实际要用c.Request().URL.Query().Get("key")或更推荐的c.Param("key")的**重载行为**：Buffalo 会自动把 query 和 form 合并进c.Params()，但前提是先调用c.Request().ParseForm() - POST/PUT 的
application/x-www-form-urlencoded数据，也需先触发ParseForm()，否则Request.PostForm为空 - JSON 请求体不能用
ParseForm()，得用c.Bind()配合结构体
为什么 c.Param() 有时能取到 query，有时不行
Buffalo 的 c.Param() 是个“合并访问器”：它内部优先查路由参数，再 fallback 到 Query() 和 PostForm()，但这个 fallback **仅在 ParseForm() 已被调用的前提下生效**。而 Buffalo 的中间件链默认不自动调用它——除非你用了 binding 或显式配置了 ParseForm 中间件。
所以真实情况是：c.Param("q") 在没调 ParseForm() 时返回空，不是 bug，是设计约束。
- 安全考虑：避免对大体积请求体（如文件上传）无差别解析
- 性能权衡：不是所有 handler 都需要 form 解析，跳过可省开销
- 兼容性：保持与标准
net/http行为一致，降低学习成本
处理 multipart/form-data（含文件上传）的注意事项
当表单包含 <input type="file">，Content-Type 变为 multipart/form-data，此时不能再依赖 ParseForm() —— 它只处理 urlencoded。必须用 c.Request().ParseMultipartForm()，且需提前设置内存阈值，否则可能因临时文件写入失败而 panic。
Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
错误现象：上传文件时返回 500，日志出现 http: request body too large 或 no such file or directory。
- 在 handler 开头加
c.Request().ParseMultipartForm(32 （32MB 限制） - 文件字段用
c.Request().FormFile("avatar")获取，不是c.Param() - 普通文本字段仍可用
c.Request().FormValue("title")，无需再走Param() - Buffalo 没有内置文件保存逻辑，
FormFile返回的是multipart.File接口，需手动io.Copy到磁盘或对象存储
JSON 请求体绑定：别用 Param，用 Bind
前端发 application/json，后端还试图用 c.Param("user_id") 取值？这注定失败。Buffalo 的 c.Param() 完全不触碰请求体，它只看 URL 和表单。
正确路径是定义结构体 + c.Bind()：
type UserCreate struct {
Name string `json:"name" valid:"required"`
Email string `json:"email" valid:"email"`
}
func Create(c buffalo.Context) error {
var u UserCreate
if err := c.Bind(&u); err != nil {
return c.Error(400, err)
}
// u.Name, u.Email 已就绪
return c.Render(201, r.JSON(u))
}
注意：Bind() 内部会根据 Content-Type 自动选择解析方式（JSON / XML / form），但不会覆盖 c.Params()，也不会影响 c.Param() 的行为。
容易被忽略的点：如果 JSON 字段名和结构体字段 tag 不一致，或类型不匹配（比如传字符串给 int 字段），Bind() 会静默失败或填充零值——务必检查返回的 err，别假设它一定成功。
