Revel控制器参数自动绑定仅支持string、int等基础类型及导出结构体,嵌套struct/map需c.Params.Bind();路径/查询参数统一进c.Params,但表单和JSON需手动处理。

控制器方法参数自动绑定只适用于简单类型和导出结构体
Revel 会把同名请求参数(路径、查询、表单)直接转成控制器方法的形参,但仅限 string、int、int64、float64、bool 及其指针,还有 []T(T 是上述类型)和字段首字母大写的 struct。比如:
func (c UserController) Update(id string, age int, active bool, tags []string) revel.Result { ... }
若 URL 是 /user?id=abc&age=25&active=true,这些值就能自动进来。但注意:
-
age缺失时是0,不是报错;无法区分“没传”和“传了 0” -
active只认"true"、"on"、"1"为 true,?active=false或?active=0都是 false - 嵌套 struct、map、自定义类型不支持自动绑定,必须手动处理
- 前端传切片要用
tags[]=a&tags[]=b,不能写成tags=a,b
c.Params.Get() 适合动态字段或需要原始字符串值
当你不确定字段名(比如用户自定义筛选条件),或想避开类型转换干扰,就该用 c.Params.Get("key")。它返回 string,未提供则为空字符串 "",不会 panic。
例如请求 /search?name=Foo+Bar&limit=10:
-
c.Params.Get("name")返回"Foo Bar"(已解码) -
c.Params.Get("limit")返回"10",不是int—— 如果要数值,得自己strconv.Atoi - 判断是否存在:用
if name := c.Params.Get("name"); name == "",别依赖len(c.Params.Values["name"]) > 0 - 要取全部同名值(如
?tag=a&tag=b&tag=c),得用c.Params.Values["tag"],它返回[]string
c.Params.Bind() 是处理切片、time.Time 和结构体的唯一可靠方式
自动绑定对 []int、time.Time、[]User 这类目标不可靠,必须显式调用 c.Params.Bind()。
比如接收时间参数 ?start=2026-10-01&end=2026-10-31:
var start, end time.Time c.Params.Bind(&start, "start") c.Params.Bind(&end, "end")
再比如绑定结构体:
type Filter struct {
Name string `json:"name"`
Limit int `json:"limit"`
}
var f Filter
c.Params.Bind(&f, "filter") // 要求请求里是 ?filter.Name=abc&filter.Limit=20
注意点:
- 结构体字段必须首字母大写(导出)
- 切片绑定支持两种语法:
ids[]=1&ids[]=2(无序)或ids[0]=1&ids[1]=2(有序) - 时间格式默认只认
"2006-01-02"和"2006-01-02 15:04";加新格式要改revel.TimeFormats
别混淆参数来源:路径参数、查询参数、表单字段都进 c.Params,但行为不同
c.Params 是统一容器,但不同来源的参数进入方式和可用性有差异:
- 路径参数(如
/users/:id)和查询参数(如?name=abc)都进c.Params.Values,名字相同会覆盖 —— 比如同时有/users/123和?id=456,c.Params.Get("id")拿到的是"456" - POST/PUT 表单字段(
application/x-www-form-urlencoded)不会自动填进c.Params.Form;必须用方法参数绑定,或先调c.Request.ParseForm()再取 - JSON 请求体完全不进
c.Params;必须手动读c.Request.Body并json.Unmarshal - 文件上传走
c.Params.Files,和普通参数分离,需单独处理
最易被忽略的是:路由里写 GET /company?name=string APP.ShowByName 会导致整个路由失效 —— Revel 的路由解析器根本不识别 ? 后的内容,只按路径前缀匹配。所有查询参数一律靠 c.Params.Get() 或方法参数接收,别往 routes 里塞。











